Windows Store App 用户库文件操作

时间:2023-03-08 17:06:20

(1)获取用户库位置

如果想要通过应用程序在用户库中创建文件,首先需要获得用户库中指定的位置,例如图片库、文档库等。这里值得注意的是,在获取用户库的位置之前,必须在Windows应用商店项目的清单文件Package.appxmanifest中开启相应的访问权限,如果应用需要访问音乐库,就需要在Package.appxmanifest文件的功能选项卡中勾选“音乐库”,如图13-4所示。

图13-4 开启访问音乐库的权限

以此类推,如果需要访问其他的库位置,可勾选相应的选项以开启访问权限。

在开启相应的权限之后,使用API参考中介绍的KnownFolders类的常用属性就可以获取到音乐库、图片库等位置。示例代码如下所示:

//获取文档库位置

StorageFolder documentFolder = KnownFolders.DocumentsLibrary;

//获取音乐库位置

StorageFolder musicFolder = KnownFolders.MusicLibrary;

//获取图片库位置

StorageFolder pictureFolder = KnownFolders.PicturesLibrary;

(2)创建文件

在获取了用户库位置之后,使用CreateFileAsync方法及其重载可以在用户库中创建文件,该方法需要获得一个参数来指定文件的名称,如果需要还可以使用另一个CreationCollisionOption类型的参数,指定如果已经存在同名文件时应该执行的操作。CreationCollisionOption是一个枚举,包含四个枚举成员,如下所示:

q  GenerateUniqueName,如果存在同名文件,创建文件时自动在文件名称后面追加一个数字。

q  ReplaceExisting,如果存在同名文件,创建文件时将其替换。

q  FailIfExists,如果存在同名文件,则返回错误。

q  OpenIfExists,如果存在同名文件,则将其打开。

下面的示例代码获取文档库,并在其中创建test.txt文件,若存在同名文件则将其替换。

StorageFolder storageFolder = KnownFolders.DocumentsLibrary;

StorageFile file = await storageFolder.CreateFileAsync("test.txt ", CreationCollisionOption.ReplaceExisting);

(3)文件读写

在文档库中创建了一个test.txt文件之后,若想对其进行写入和读取文本的操作,可以通过调用FileIO类的WriteTextAsync和ReadTextAsync方法来实现,示例代码如下所示:

//写入文本

await Windows.Storage.FileIO.WriteTextAsync(file, "内容字符串");

//读取文本

string text = await Windows.Storage.FileIO.ReadTextAsync(file);

除了以文本方式读写文件以外,还能以数据流的形式读写文件。在以数据流的形式写入文件内容时,首先需要通过StorageFile类的OpenAsync方法得到用于写入文件内容的数据流,然后创建一个DataWriter类的对象,使用DataWriter对象的WriteString方法将文本写入到输出流中,写入完成后,调用StoreAsync和FlushAsync方法保存文本并关闭输出流。示例代码如下所示:

var stream = await file.OpenAsync(Windows.Storage.FileAccessMode.ReadWrite);

using(var outputStream = stream.GetOutputStreamAt(0))

{

    //文件进行写入操作

    DataWriter dataWriter = new DataWriter(outputStream);

    dataWriter.WriteString("字符串内容");

    await dataWriter.StoreAsync();

    await outputStream.FlushAsync();

}

与写入文件相似,在以数据流形式读取文件时,同样需要首先通过调用OpenAsync方法获得读取文件的数据流,但与写入不同的是,读取文件需要使用DataReader类,通过此类的LoadAsync方法将文件中的内容以数据流的形式读取出来。示例代码如下所示:

var stream = await file.OpenAsync(Windows.Storage.FileAccessMode.ReadWrite);

uint size = (uint)stream.Size;

using (var inputStream = stream.GetInputStreamAt(0))

{

   //读取文件的操作

   DataReader dataReader = new DataReader(inputStream);

   uint numBytesLoaded = await dataReader.LoadAsync(size);

   string text = dataReader.ReadString(numBytesLoaded);

}

除了以上两种读写文件的方式,还可通过字节的方式读写文件,采用这种方式,需要一个缓冲区来存储读写数据。这种方式并不常用,在这里就不做过多介绍了,感兴趣的读者可以查阅相关资料。