/**
文件操作类
**/
#region 引用命名空间
using System;
using System.Collections.Generic;
using System.Text;
using System.IO;
#endregion
namespace CommonUtilities
{
/// <summary>
/// 文件操作类
/// </summary>
public class FileHelper
{
#region 检测指定目录是否存在
/// <summary>
/// 检测指定目录是否存在
/// </summary>
/// <param name="directoryPath">目录的绝对路径</param>
public static bool IsExistDirectory( string directoryPath )
{
return Directory.Exists( directoryPath );
}
#endregion
#region 检测指定文件是否存在
/// <summary>
/// 检测指定文件是否存在,如果存在则返回true。
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static bool IsExistFile( string filePath )
{
return File.Exists( filePath );
}
#endregion
#region 检测指定目录是否为空
/// <summary>
/// 检测指定目录是否为空
/// </summary>
/// <param name="directoryPath">指定目录的绝对路径</param>
public static bool IsEmptyDirectory( string directoryPath )
{
try
{
//判断是否存在文件
string[] fileNames = GetFileNames( directoryPath );
if ( fileNames.Length > 0 )
{
return false;
}
//判断是否存在文件夹
string[] directoryNames = GetDirectories( directoryPath );
if ( directoryNames.Length > 0 )
{
return false;
}
return true;
}
catch ( Exception ex )
{
LogHelper.WriteTraceLog( TraceLogLevel.Error, ex.Message );
return true;
}
}
#endregion
#region 检测指定目录中是否存在指定的文件
/// <summary>
/// 检测指定目录中是否存在指定的文件,若要搜索子目录请使用重载方法.
/// </summary>
/// <param name="directoryPath">指定目录的绝对路径</param>
/// <param name="searchPattern">模式字符串,"*"代表0或N个字符,"?"代表1个字符。
/// 范例:"Log*.xml"表示搜索所有以Log开头的Xml文件。</param>
public static bool Contains( string directoryPath, string searchPattern )
{
try
{
//获取指定的文件列表
string[] fileNames = GetFileNames( directoryPath, searchPattern, false );
//判断指定文件是否存在
if ( fileNames.Length == 0 )
{
return false;
}
else
{
return true;
}
}
catch ( Exception ex )
{
LogHelper.WriteTraceLog( TraceLogLevel.Error, ex.Message );
return false;
}
}
/// <summary>
/// 检测指定目录中是否存在指定的文件
/// </summary>
/// <param name="directoryPath">指定目录的绝对路径</param>
/// <param name="searchPattern">模式字符串,"*"代表0或N个字符,"?"代表1个字符。
/// 范例:"Log*.xml"表示搜索所有以Log开头的Xml文件。</param>
/// <param name="isSearchChild">是否搜索子目录</param>
public static bool Contains( string directoryPath, string searchPattern, bool isSearchChild )
{
try
{
//获取指定的文件列表
string[] fileNames = GetFileNames( directoryPath, searchPattern, true );
//判断指定文件是否存在
if ( fileNames.Length == 0 )
{
return false;
}
else
{
return true;
}
}
catch ( Exception ex )
{
LogHelper.WriteTraceLog( TraceLogLevel.Error, ex.Message );
return false;
}
}
#endregion
#region 创建一个目录
/// <summary>
/// 创建一个目录
/// </summary>
/// <param name="directoryPath">目录的绝对路径</param>
public static void CreateDirectory( string directoryPath )
{
//如果目录不存在则创建该目录
if ( !IsExistDirectory( directoryPath ) )
{
Directory.CreateDirectory( directoryPath );
}
}
#endregion
#region 创建一个文件
/// <summary>
/// 创建一个文件。
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static void CreateFile( string filePath )
{
try
{
//如果文件不存在则创建该文件
if ( !IsExistFile( filePath ) )
{
//创建一个FileInfo对象
FileInfo file = new FileInfo( filePath );
//创建文件
FileStream fs = file.Create();
//关闭文件流
fs.Close();
}
}
catch ( Exception ex )
{
LogHelper.WriteTraceLog( TraceLogLevel.Error, ex.Message );
throw ex;
}
}
/// <summary>
/// 创建一个文件,并将字节流写入文件。
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
/// <param name="buffer">二进制流数据</param>
public static void CreateFile( string filePath, byte[] buffer )
{
try
{
//如果文件不存在则创建该文件
if ( !IsExistFile( filePath ) )
{
//创建一个FileInfo对象
FileInfo file = new FileInfo( filePath );
//创建文件
FileStream fs = file.Create();
//写入二进制流
fs.Write( buffer, 0, buffer.Length );
//关闭文件流
fs.Close();
}
}
catch ( Exception ex )
{
LogHelper.WriteTraceLog( TraceLogLevel.Error, ex.Message );
throw ex;
}
}
#endregion
#region 获取文本文件的行数
/// <summary>
/// 获取文本文件的行数
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static int GetLineCount( string filePath )
{
//将文本文件的各行读到一个字符串数组中
string[] rows = File.ReadAllLines( filePath );
//返回行数
return rows.Length;
}
#endregion
#region 获取一个文件的长度
/// <summary>
/// 获取一个文件的长度,单位为Byte
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static int GetFileSize( string filePath )
{
//创建一个文件对象
FileInfo fi = new FileInfo( filePath );
//获取文件的大小
return (int)fi.Length;
}
/// <summary>
/// 获取一个文件的长度,单位为KB
/// </summary>
/// <param name="filePath">文件的路径</param>
public static double GetFileSizeByKB( string filePath )
{
//创建一个文件对象
FileInfo fi = new FileInfo( filePath );
//获取文件的大小
return ConvertHelper.ToDouble( ConvertHelper.ToDouble( fi.Length ) / 1024 , 1 );
}
/// <summary>
/// 获取一个文件的长度,单位为MB
/// </summary>
/// <param name="filePath">文件的路径</param>
public static double GetFileSizeByMB( string filePath )
{
//创建一个文件对象
FileInfo fi = new FileInfo( filePath );
//获取文件的大小
return ConvertHelper.ToDouble( ConvertHelper.ToDouble( fi.Length ) / 1024 / 1024 , 1 );
}
#endregion
#region 获取指定目录中的文件列表
/// <summary>
/// 获取指定目录中所有文件列表
/// </summary>
/// <param name="directoryPath">指定目录的绝对路径</param>
public static string[] GetFileNames( string directoryPath )
{
//如果目录不存在,则抛出异常
if ( !IsExistDirectory( directoryPath ) )
{
throw new FileNotFoundException();
}
//获取文件列表
return Directory.GetFiles( directoryPath );
}
/// <summary>
/// 获取指定目录及子目录中所有文件列表
/// </summary>
/// <param name="directoryPath">指定目录的绝对路径</param>
/// <param name="searchPattern">模式字符串,"*"代表0或N个字符,"?"代表1个字符。
/// 范例:"Log*.xml"表示搜索所有以Log开头的Xml文件。</param>
/// <param name="isSearchChild">是否搜索子目录</param>
public static string[] GetFileNames( string directoryPath, string searchPattern, bool isSearchChild )
{
//如果目录不存在,则抛出异常
if ( !IsExistDirectory( directoryPath ) )
{
throw new FileNotFoundException();
}
try
{
if ( isSearchChild )
{
return Directory.GetFiles( directoryPath, searchPattern, SearchOption.AllDirectories );
}
else
{
return Directory.GetFiles( directoryPath, searchPattern, SearchOption.TopDirectoryOnly );
}
}
catch ( IOException ex )
{
throw ex;
}
}
#endregion
#region 获取指定目录中的子目录列表
/// <summary>
/// 获取指定目录中所有子目录列表,若要搜索嵌套的子目录列表,请使用重载方法.
/// </summary>
/// <param name="directoryPath">指定目录的绝对路径</param>
public static string[] GetDirectories( string directoryPath )
{
try
{
return Directory.GetDirectories( directoryPath );
}
catch ( IOException ex )
{
throw ex;
}
}
/// <summary>
/// 获取指定目录及子目录中所有子目录列表
/// </summary>
/// <param name="directoryPath">指定目录的绝对路径</param>
/// <param name="searchPattern">模式字符串,"*"代表0或N个字符,"?"代表1个字符。
/// 范例:"Log*.xml"表示搜索所有以Log开头的Xml文件。</param>
/// <param name="isSearchChild">是否搜索子目录</param>
public static string[] GetDirectories( string directoryPath, string searchPattern, bool isSearchChild )
{
try
{
if ( isSearchChild )
{
return Directory.GetDirectories( directoryPath, searchPattern, SearchOption.AllDirectories );
}
else
{
return Directory.GetDirectories( directoryPath, searchPattern, SearchOption.TopDirectoryOnly );
}
}
catch ( IOException ex )
{
throw ex;
}
}
#endregion
#region 向文本文件写入内容
/// <summary>
/// 向文本文件中写入内容
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
/// <param name="content">写入的内容</param>
public static void WriteText( string filePath, string content )
{
//向文件写入内容
File.WriteAllText( filePath, content );
}
#endregion
#region 向文本文件的尾部追加内容
/// <summary>
/// 向文本文件的尾部追加内容
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
/// <param name="content">写入的内容</param>
public static void AppendText( string filePath, string content )
{
File.AppendAllText( filePath, content );
}
#endregion
#region 将现有文件的内容复制到新文件中
/// <summary>
/// 将源文件的内容复制到目标文件中
/// </summary>
/// <param name="sourceFilePath">源文件的绝对路径</param>
/// <param name="destFilePath">目标文件的绝对路径</param>
public static void Copy( string sourceFilePath, string destFilePath )
{
File.Copy( sourceFilePath, destFilePath, true );
}
#endregion
#region 将文件移动到指定目录
/// <summary>
/// 将文件移动到指定目录
/// </summary>
/// <param name="sourceFilePath">需要移动的源文件的绝对路径</param>
/// <param name="descDirectoryPath">移动到的目录的绝对路径</param>
public static void Move( string sourceFilePath,string descDirectoryPath )
{
//获取源文件的名称
string sourceFileName = GetFileName( sourceFilePath );
if ( IsExistDirectory( descDirectoryPath ) )
{
//如果目标中存在同名文件,则删除
if ( IsExistFile( descDirectoryPath + "\\" + sourceFileName ) )
{
DeleteFile( descDirectoryPath + "\\" + sourceFileName );
}
//将文件移动到指定目录
File.Move( sourceFilePath, descDirectoryPath + "\\" + sourceFileName );
}
}
#endregion
#region 将流读取到缓冲区中
/// <summary>
/// 将流读取到缓冲区中
/// </summary>
/// <param name="stream">原始流</param>
public static byte[] StreamToBytes( Stream stream )
{
try
{
//创建缓冲区
byte[] buffer = new byte[stream.Length];
//读取流
stream.Read( buffer, 0, ConvertHelper.ToInt32( stream.Length ) );
//返回流
return buffer;
}
catch ( Exception ex )
{
LogHelper.WriteTraceLog( TraceLogLevel.Error, ex.Message );
throw ex;
}
finally
{
//关闭流
stream.Close();
}
}
#endregion
#region 将文件读取到缓冲区中
/// <summary>
/// 将文件读取到缓冲区中
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static byte[] FileToBytes( string filePath )
{
//获取文件的大小
int fileSize = GetFileSize( filePath );
//创建一个临时缓冲区
byte[] buffer = new byte[fileSize];
//创建一个文件流
FileInfo fi = new FileInfo( filePath );
FileStream fs = fi.Open( FileMode.Open );
try
{
//将文件流读入缓冲区
fs.Read( buffer, 0, fileSize );
return buffer;
}
catch ( IOException ex )
{
LogHelper.WriteTraceLog( TraceLogLevel.Error, ex.Message );
throw ex;
}
finally
{
//关闭文件流
fs.Close();
}
}
#endregion
#region 将文件读取到字符串中
/// <summary>
/// 将文件读取到字符串中
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static string FileToString( string filePath )
{
return FileToString( filePath, BaseInfo.DefaultEncoding );
}
/// <summary>
/// 将文件读取到字符串中
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
/// <param name="encoding">字符编码</param>
public static string FileToString( string filePath,Encoding encoding )
{
//创建流读取器
StreamReader reader = new StreamReader( filePath, encoding );
try
{
//读取流
return reader.ReadToEnd();
}
catch ( Exception ex )
{
LogHelper.WriteTraceLog( TraceLogLevel.Error, ex.Message );
throw ex;
}
finally
{
//关闭流读取器
reader.Close();
}
}
#endregion
#region 从文件的绝对路径中获取文件名( 包含扩展名 )
/// <summary>
/// 从文件的绝对路径中获取文件名( 包含扩展名 )
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static string GetFileName( string filePath )
{
//获取文件的名称
FileInfo fi = new FileInfo( filePath );
return fi.Name;
}
#endregion
#region 从文件的绝对路径中获取文件名( 不包含扩展名 )
/// <summary>
/// 从文件的绝对路径中获取文件名( 不包含扩展名 )
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static string GetFileNameNoExtension( string filePath )
{
//获取文件的名称
FileInfo fi = new FileInfo( filePath );
return fi.Name.Split( ‘.‘ )[0];
}
#endregion
#region 从文件的绝对路径中获取扩展名
/// <summary>
/// 从文件的绝对路径中获取扩展名
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static string GetExtension( string filePath )
{
//获取文件的名称
FileInfo fi = new FileInfo( filePath );
return fi.Extension;
}
#endregion
#region 清空指定目录
/// <summary>
/// 清空指定目录下所有文件及子目录,但该目录依然保存.
/// </summary>
/// <param name="directoryPath">指定目录的绝对路径</param>
public static void ClearDirectory( string directoryPath )
{
if ( IsExistDirectory( directoryPath ) )
{
//删除目录中所有的文件
string[] fileNames = GetFileNames( directoryPath );
for ( int i = 0; i < fileNames.Length; i++ )
{
DeleteFile( fileNames[i] );
}
//删除目录中所有的子目录
string[] directoryNames = GetDirectories( directoryPath );
for ( int i = 0; i < directoryNames.Length; i++ )
{
DeleteDirectory( directoryNames[i] );
}
}
}
#endregion
#region 清空文件内容
/// <summary>
/// 清空文件内容
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static void ClearFile( string filePath )
{
//删除文件
File.Delete( filePath );
//重新创建该文件
CreateFile( filePath );
}
#endregion
#region 删除指定文件
/// <summary>
/// 删除指定文件
/// </summary>
/// <param name="filePath">文件的绝对路径</param>
public static void DeleteFile( string filePath )
{
if ( IsExistFile( filePath ) )
{
File.Delete( filePath );
}
}
#endregion
#region 删除指定目录
/// <summary>
/// 删除指定目录及其所有子目录
/// </summary>
/// <param name="directoryPath">指定目录的绝对路径</param>
public static void DeleteDirectory( string directoryPath )
{
if ( IsExistDirectory( directoryPath ) )
{
Directory.Delete( directoryPath, true );
}
}
#endregion
}
}