StorageFolder.GetFoldersAsync Method

Definition

Overloads

public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync()

using Windows.Storage;
using Windows.Storage.Search;
using System.Threading.Tasks;
using System.Diagnostics; // For writing results to Output window.

// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;

// Get the files in the subfolders of the user's Pictures folder,
// grouped by month. Get only the first 4 folders (months).
IReadOnlyList <StorageFolder> groupedItems = await picturesFolder.GetFoldersAsync(CommonFolderQuery.GroupByMonth, 0, 4);

// Iterate over the results and print the list of folders
// and files to the Visual Studio Output window.
foreach (StorageFolder folder in groupedItems)
{
    Debug.WriteLine(folder.Name);

    // To iterate over the files in each folder, uncomment the following lines. 
    // foreach(StorageFile file in await folder.GetFilesAsync())
    //    Debug.WriteLine(" " + file.Name);
}

// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder^ picturesFolder = KnownFolders::PicturesLibrary;

// Get the files in the user's Pictures folder, grouped by month.
// Get only the first 4 folders (months).
create_task(picturesFolder->GetFoldersAsync(CommonFolderQuery::GroupByMonth)).then([=](IVectorView<StorageFolder^>^ itemsInFolder) {
 //Iterate over the results and print the list of file groups
 // to the visual studio output window
 for (auto it = itemsInFolder->First(); it->HasCurrent; it->MoveNext())
 {
  StorageFolder^ file = it->Current;
  String^ output = file->Name + "
";
  OutputDebugString(output->Begin());
 }
});

public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync(CommonFolderQuery query)

public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync(CommonFolderQuery query, UInt32 startIndex, UInt32 maxItemsToRetrieve)

Segoe MDL2 icon guidelines - UWP app developer _ Microsoft Docs.pdf

선택기를 사용하여 파일 및 폴더 열기

• 2017. 02. 08.
• 읽는 데 3분

[ Windows 10의 UWP 앱에 맞게 업데이트되었습니다. Windows 8.x 문서는 보관을 참조하세요. ]

중요 API

• FileOpenPicker
• FolderPicker
• StorageFile

사용자가 선택기를 조작할 수 있도록 하여 파일 및 폴더에 액세스합니다. FileOpenPicker 및 FileSavePicker 클래스를 사용하여 파일에 액세스하고 FolderPicker 클래스를 사용하여 폴더에 액세스할 수 있습니다.

참고 전체 샘플에 대해서는 파일 선택기 샘플을 참조하세요.

필수 조건

• UWP(유니버설 Windows 플랫폼) 앱에 대한 비동기 프로그래밍 이해

  C# 또는 Visual Basic에서 비동기 앱을 작성하는 방법에 대한 자세한 내용은 C# 또는 Visual Basic에서 비동기식 API 호출을 참조하세요. C++에서 비동기 앱을 작성하는 방법은 C++의 비동기 프로그래밍을 참조하세요.

• 위치에 대한 액세스 권한

  파일 액세스 권한을 참조하세요.

파일 선택기 UI

파일 선택기는 사용자를 안내하고 파일을 열거나 저장할 때 일관된 환경을 제공하기 위해 정보를 표시합니다.

이러한 정보에는 다음이 포함됩니다.

• 현재 위치
• 사용자가 선택한 항목
• 사용자가 이동할 수 있는 위치의 트리. 이러한 위치에는 파일 시스템 위치(예: 음악 또는 다운로드 폴더) 파일 선택기 계약을 구현하는 앱(예: 카메라, 사진 및 Microsoft OneDrive)이 포함됩니다.

메일 앱은 사용자가 첨부 파일을 선택할 수 있도록 파일 선택기를 표시할 수 있습니다.

선택기 작동 방식

선택기를 통해 앱은 사용자 시스템의 파일 및 폴더를 액세스하고 찾아보고 저장할 수 있습니다. 앱은 사용자가 작업할 수 있도록 StorageFile 및 StorageFolder 개체로 이러한 선택을 수신합니다.

선택기는 통합된 단일 인터페이스를 사용하여 사용자가 파일 시스템이나 다른 앱에서 파일 및 폴더를 선택할 수 있도록 합니다. 다른 앱에서 선택한 파일은 파일 시스템의 파일과 유사하며 StorageFile 개체로 반환됩니다. 일반적으로 앱은 다른 개체와 동일한 방식으로 해당 개체에서 작동할 수 있습니다. 다른 앱에서는 파일 선택기 계약에 참여함으로써 파일을 사용할 수 있게 합니다. 앱에서 다른 앱에 파일, 저장 위치 또는 파일 업데이트를 제공하도록 하려면 파일 선택기 계약과 통합을 참조하세요.

예를 들어 사용자가 파일을 열 수 있도록 앱에서 파일 선택기를 호출할 수 있습니다. 그러면 해당 앱이 호출 앱이 됩니다. 파일 선택기는 시스템 및/또는 다른 앱과 상호 작용하여 사용자가 파일을 탐색하고 선택할 수 있도록 합니다. 사용자가 파일을 선택하면 파일 선택기는 해당 파일을 앱에 반환합니다. 사용자가 OneDrive와 같은 제공 앱에서 파일을 선택할 경우의 프로세스는 다음과 같습니다.

단일 파일 선택: 전체 코드 목록

var picker = new Windows.Storage.Pickers.FileOpenPicker();
picker.ViewMode = Windows.Storage.Pickers.PickerViewMode.Thumbnail;
picker.SuggestedStartLocation =
    Windows.Storage.Pickers.PickerLocationId.PicturesLibrary;
picker.FileTypeFilter.Add(".jpg");
picker.FileTypeFilter.Add(".jpeg");
picker.FileTypeFilter.Add(".png");

Windows.Storage.StorageFile file = await picker.PickSingleFileAsync();
if (file != null)
{
    // Application now has read/write access to the picked file
    this.textBlock.Text = "Picked photo: " + file.Name;
}
else
{
    this.textBlock.Text = "Operation cancelled.";
}

단일 파일 선택: 단계별

파일 선택기 사용에는 파일 선택기 개체를 만들고 사용자 지정한 다음 사용자가 하나 이상의 항목을 선택할 수 있도록 파일 선택기를 표시하는 과정이 포함됩니다.

1. FileOpenPicker 만들기 및 사용자 지정

   CSharp복사

   var picker = new Windows.Storage.Pickers.FileOpenPicker();
       picker.ViewMode = Windows.Storage.Pickers.PickerViewMode.Thumbnail;
       picker.SuggestedStartLocation =
           Windows.Storage.Pickers.PickerLocationId.PicturesLibrary;
       picker.FileTypeFilter.Add(".jpg");
       picker.FileTypeFilter.Add(".jpeg");
       picker.FileTypeFilter.Add(".png");
   

   사용자 및 앱과 관련된 파일 선택기 개체에서 속성을 설정합니다. 파일 선택기 사용자 지정 방법을 결정하는 데 도움이 되는 지침은 파일 선택기에 대한 지침 및 검사 목록을 참조하세요.

   이 예제에서는 세 가지 속성(ViewMode, SuggestedStartLocation 및 FileTypeFilter)을 설정하여 사용자가 선택할 수 있는 편리한 위치에 사진의 풍부한 시각적 표시를 만듭니다.

   • ViewMode를 PickerViewMode Thumbnail 열거 값으로 설정하면 사진 미리 보기를 사용하여 파일 선택기에 파일을 표시함으로써 풍부한 시각적 표시가 만들어집니다. 이렇게 하려면 사진이나 비디오와 같은 시각적 파일을 선택합니다. 그렇지 않으면 PickerViewMode.List를 사용합니다. 사진 또는 비디오 첨부 및 문서 첨부 기능이 있는 가상 메일 앱은 파일 선택기를 표시하기 전에 기능에 적합한 ViewMode를 설정합니다.

   • PickerLocationId.PicturesLibrary를 사용하여 SuggestedStartLocation을 사진으로 설정하면 사용자가 사진을 찾을 수 있을 것 같은 위치에서 시작됩니다. SuggestedStartLocation을 선택하려는 파일 형식(예: 음악, 사진, 동영상 또는 문서)에 적절한 위치로 설정합니다. 사용자는 시작 위치에서 다른 위치로 이동할 수 있습니다.

   • FileTypeFilter를 사용하여 파일 형식을 지정하면 사용자가 관련 있는 파일을 선택하는 데 집중할 수 있습니다. FileTypeFilter의 이전 파일 형식을 새 항목으로 대체하려면 Add 대신 ReplaceAll을 사용합니다.

2. FileOpenPicker 표시

   • 단일 파일을 선택하려면
   CSharp복사

   Windows.Storage.StorageFile file = await picker.PickSingleFileAsync();
           if (file != null)
           {
               // Application now has read/write access to the picked file
               this.textBlock.Text = "Picked photo: " + file.Name;
           }
           else
           {
               this.textBlock.Text = "Operation cancelled.";
           }
   

   • 여러 파일을 선택하려면
   CSharp복사

   var files = await picker.PickMultipleFilesAsync();
           if (files.Count > 0)
           {
               StringBuilder output = new StringBuilder("Picked files:\n");
   
               // Application now has read/write access to the picked file(s)
               foreach (Windows.Storage.StorageFile file in files)
               {
                   output.Append(file.Name + "\n");
               }
               this.textBlock.Text = output.ToString();
           }
           else
           {
               this.textBlock.Text = "Operation cancelled.";
           }
   

폴더 선택: 전체 코드 목록

var folderPicker = new Windows.Storage.Pickers.FolderPicker();
folderPicker.SuggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.Desktop;
folderPicker.FileTypeFilter.Add("*");

Windows.Storage.StorageFolder folder = await folderPicker.PickSingleFolderAsync();
if (folder != null)
{
    // Application now has read/write access to all contents in the picked folder
    // (including other sub-folder contents)
    Windows.Storage.AccessCache.StorageApplicationPermissions.
    FutureAccessList.AddOrReplace("PickedFolderToken", folder);
    this.textBlock.Text = "Picked folder: " + folder.Name;
}
else
{
    this.textBlock.Text = "Operation cancelled.";
}

팁 앱이 선택기를 통해 파일 또는 폴더에 액세스할 경우 해당 항목을 앱의 FutureAccessList 또는 MostRecentlyUsedList에 추가하여 추적합니다. 이러한 목록을 사용하는 방법에 대한 자세한 내용은 최근에 사용한 파일 및 폴더를 추적하는 방법을 참조하세요.

파일 만들기, 쓰기 및 읽기

• 2017. 07. 05.
• 읽는 데 5분

[ Windows 10의 UWP 앱에 맞게 업데이트되었습니다. Windows 8.x 문서는 보관을 참조하세요. ]

중요 API

• StorageFolder 클래스
• StorageFile 클래스
• FileIO 클래스

StorageFile 개체를 사용하여 파일을 읽고 씁니다.

필수 조건

• UWP(유니버설 Windows 플랫폼) 앱에 대한 비동기 프로그래밍 이해

  C# 또는 Visual Basic에서 비동기 앱을 작성하는 방법에 대한 자세한 내용은 C# 또는 Visual Basic에서 비동기식 API 호출을 참조하세요. C++에서 비동기 앱을 작성하는 방법은 C++의 비동기 프로그래밍을 참조하세요.

• 읽거나, 쓰거나, 일고 쓸 파일을 가져오는 방법에 대해 알아봅니다.

  파일 선택기를 사용하여 파일을 가져오는 방법은 선택기를 사용하여 파일 및 폴더 열기를 참조하세요.

파일 만들기

앱의 로컬 폴더에 파일을 만드는 방법은 다음과 같습니다. 이미 있는 경우 바꿉니다.

// Create sample file; replace if exists.
Windows.Storage.StorageFolder storageFolder =
    Windows.Storage.ApplicationData.Current.LocalFolder;
Windows.Storage.StorageFile sampleFile =
    await storageFolder.CreateFileAsync("sample.txt",
        Windows.Storage.CreationCollisionOption.ReplaceExisting);

// Create a sample file; replace if exists.
StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
concurrency::create_task(storageFolder->CreateFileAsync("sample.txt", CreationCollisionOption::ReplaceExisting));

' Create sample file; replace if exists.
Dim storageFolder As StorageFolder = Windows.Storage.ApplicationData.Current.LocalFolder
Dim sampleFile As StorageFile = Await storageFolder.CreateFileAsync("sample.txt", CreationCollisionOption.ReplaceExisting)

파일에 쓰기

StorageFile 클래스를 사용하여 디스크의 쓰기 가능 파일에 쓰는 방법은 다음과 같습니다. 파일에 쓰는 각 방법의 공통적인 첫 번째 단계(파일을 만든 즉시 해당 파일에 쓰는 경우 제외)는 StorageFolder.GetFileAsync를 사용하여 파일을 가져오는 것입니다.

Windows.Storage.StorageFolder storageFolder =
    Windows.Storage.ApplicationData.Current.LocalFolder;
Windows.Storage.StorageFile sampleFile =
    await storageFolder.GetFileAsync("sample.txt");

StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
create_task(storageFolder->GetFileAsync("sample.txt")).then([](StorageFile^ sampleFile) 
{
    // Process file
});

Dim storageFolder As StorageFolder = Windows.Storage.ApplicationData.Current.LocalFolder
Dim sampleFile As StorageFile = Await storageFolder.GetFileAsync("sample.txt")

파일에 텍스트 쓰기

FileIO 클래스의 WriteTextAsync 메서드를 호출하여 파일에 텍스트를 씁니다.

await Windows.Storage.FileIO.WriteTextAsync(sampleFile, "Swift as a shadow");

StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
create_task(storageFolder->GetFileAsync("sample.txt")).then([](StorageFile^ sampleFile) 
{
    //Write text to a file
    create_task(FileIO::WriteTextAsync(sampleFile, "Swift as a shadow"));
});

Await Windows.Storage.FileIO.WriteTextAsync(sampleFile, "Swift as a shadow")

버퍼를 사용하여 파일에 바이트 쓰기(2단계)

1. 먼저 ConvertStringToBinary를 호출하여 파일에 쓰려는 바이트(임의 문자열 기반)의 버퍼를 가져옵니다.

   C#복사

   var buffer = Windows.Security.Cryptography.CryptographicBuffer.ConvertStringToBinary(
           "What fools these mortals be", Windows.Security.Cryptography.BinaryStringEncoding.Utf8);
   

   C++복사

   StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
   create_task(storageFolder->GetFileAsync("sample.txt")).then([](StorageFile^ sampleFile)
   {
       // Create the buffer
       IBuffer^ buffer = CryptographicBuffer::ConvertStringToBinary
       ("What fools these mortals be", BinaryStringEncoding::Utf8);
   });
   

   VB복사

   Dim buffer = Windows.Security.Cryptography.CryptographicBuffer.ConvertStringToBinary(
                       "What fools these mortals be",
                       Windows.Security.Cryptography.BinaryStringEncoding.Utf8)
   

2. 그런 다음 FileIO 클래스의 WriteBufferAsync 메서드를 호출하여 파일에 버퍼의 바이트를 씁니다.

   C#복사

   await Windows.Storage.FileIO.WriteBufferAsync(sampleFile, buffer);
   

   C++복사

   StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
   create_task(storageFolder->GetFileAsync("sample.txt")).then([](StorageFile^ sampleFile)
   {
       // Create the buffer
       IBuffer^ buffer = CryptographicBuffer::ConvertStringToBinary
       ("What fools these mortals be", BinaryStringEncoding::Utf8);      
       // Write bytes to a file using a buffer
       create_task(FileIO::WriteBufferAsync(sampleFile, buffer));
   });
   

   VB복사

   Await Windows.Storage.FileIO.WriteBufferAsync(sampleFile, buffer)
   

스트림을 사용하여 파일에 텍스트 쓰기(4단계)

1. 먼저 StorageFile.OpenAsync 메서드를 호출하여 파일을 엽니다. 이 메서드는 열기 작업이 완료되면 파일 내용의 스트림을 반환합니다.

   C#복사

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

   C++복사

   StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
   create_task(storageFolder->GetFileAsync("sample.txt")).then([](StorageFile^ sampleFile)
   {
       create_task(sampleFile->OpenAsync(FileAccessMode::ReadWrite)).then([sampleFile](IRandomAccessStream^ stream)
       {
           // Process stream
       });
   });
   

   VB복사

   Dim stream = Await sampleFile.OpenAsync(Windows.Storage.FileAccessMode.ReadWrite)
   

2. 다음으로, stream에서 GetOutputStreamAt 메서드를 호출하여 출력 스트림을 가져옵니다. using 문에 이 스트림을 넣어 출력 스트림의 수명을 관리합니다.

   C#복사

   using (var outputStream = stream.GetOutputStreamAt(0))
   {
       // We'll add more code here in the next step.
   }
   stream.Dispose(); // Or use the stream variable (see previous code snippet) with a using statement as well.
   

   C++복사

   // Add to "Process stream" in part 1
   IOutputStream^ outputStream = stream->GetOutputStreamAt(0);
   

   VB복사

   Using outputStream = stream.GetOutputStreamAt(0)
   ' We'll add more code here in the next step.
   End Using
   

3. 이제 기존 using 문 내에 다음 코드를 추가해 새 DataWriter 개체를 만들고 DataWriter.WriteString 메서드를 호출하여 출력 스트림에 씁니다.

   C#복사

   using (var dataWriter = new Windows.Storage.Streams.DataWriter(outputStream))
   {
       dataWriter.WriteString("DataWriter has methods to write to various types, such as DataTimeOffset.");
   }
   

   C++복사

   // Added after code from part 2
   DataWriter^ dataWriter = ref new DataWriter(outputStream);
   dataWriter->WriteString("DataWriter has methods to write to various types, such as DataTimeOffset.");
   

   VB복사

   Dim dataWriter As New DataWriter(outputStream)
   dataWriter.WriteString("DataWriter has methods to write to various types, such as DataTimeOffset.")
   

4. 마지막으로, 내부 using 문 내에 다음 코드를 추가하여 StoreAsync로 텍스트를 파일에 저장하고 FlushAsync로 스트림을 닫습니다.

   C#복사

   await dataWriter.StoreAsync();
       await outputStream.FlushAsync();
   

   C++복사

   // Added after code from part 3
   dataWriter->StoreAsync();
   outputStream->FlushAsync();
   

   VB복사

   Await dataWriter.StoreAsync()
       Await outputStream.FlushAsync()
   

파일에서 읽기

StorageFile 클래스를 사용하여 디스크의 파일에서 읽는 방법은 다음과 같습니다. 파일에서 읽는 각 방법의 공통적인 첫 번째 단계는 StorageFolder.GetFileAsync를 사용하여 파일을 가져오는 것입니다.

Windows.Storage.StorageFolder storageFolder =
    Windows.Storage.ApplicationData.Current.LocalFolder;
Windows.Storage.StorageFile sampleFile =
    await storageFolder.GetFileAsync("sample.txt");

StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
create_task(storageFolder->GetFileAsync("sample.txt")).then([](StorageFile^ sampleFile)
{
    // Process file
});

Dim storageFolder As StorageFolder = Windows.Storage.ApplicationData.Current.LocalFolder
Dim sampleFile As StorageFile = Await storageFolder.GetFileAsync("sample.txt")

파일에서 텍스트 읽기

FileIO 클래스의 ReadTextAsync 메서드를 호출하여 파일에서 텍스트를 읽습니다.

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

StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
create_task(storageFolder->GetFileAsync("sample.txt")).then([](StorageFile^ sampleFile)
{
    return FileIO::ReadTextAsync(sampleFile);
});

Dim text As String = Await Windows.Storage.FileIO.ReadTextAsync(sampleFile)

버퍼를 사용하여 파일에서 텍스트 읽기(2단계)

1. 먼저 FileIO 클래스의 ReadBufferAsync 메서드를 호출합니다.

   C#복사

   var buffer = await Windows.Storage.FileIO.ReadBufferAsync(sampleFile);
   

   C++복사

   StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
   create_task(storageFolder->GetFileAsync("sample.txt")).then([](StorageFile^ sampleFile)
   {
       return FileIO::ReadBufferAsync(sampleFile);
   
   }).then([](Streams::IBuffer^ buffer)
   {
       // Process buffer
   });
   

   VB복사

   Dim buffer = Await Windows.Storage.FileIO.ReadBufferAsync(sampleFile)
   

2. 그런 다음 DataReader 개체를 사용하여 버퍼의 길이와 버퍼의 내용을 차례로 읽습니다.

   C#복사

   using (var dataReader = Windows.Storage.Streams.DataReader.FromBuffer(buffer))
   {
       string text = dataReader.ReadString(buffer.Length);
   }
   

   C++복사

   // Add to "Process buffer" section from part 1
   auto dataReader = DataReader::FromBuffer(buffer);
   String^ bufferText = dataReader->ReadString(buffer->Length);
   

   VB복사

   Dim dataReader As DataReader = Windows.Storage.Streams.DataReader.FromBuffer(buffer)
   Dim text As String = dataReader.ReadString(buffer.Length)
   

스트림을 사용하여 파일에서 텍스트 읽기(4단계)

1. StorageFile.OpenAsync 메서드를 호출하여 파일의 스트림을 엽니다. 이 메서드는 작업이 완료되면 파일 내용의 스트림을 반환합니다.

   C#복사

   var stream = await sampleFile.OpenAsync(Windows.Storage.FileAccessMode.Read);
   

   C++복사

   StorageFolder^ storageFolder = ApplicationData::Current->LocalFolder;
   create_task(storageFolder->GetFileAsync("sample.txt")).then([](StorageFile^ sampleFile)
   {
       create_task(sampleFile->OpenAsync(FileAccessMode::Read)).then([sampleFile](IRandomAccessStream^ stream)
       {
           // Process stream
       });
   });
   

   VB복사

   Dim stream = Await sampleFile.OpenAsync(Windows.Storage.FileAccessMode.Read)
   

2. 나중에 사용할 스트림의 크기를 가져옵니다.

   C#복사

   ulong size = stream.Size;
   

   C++복사

   // Add to "Process stream" from part 1
   UINT64 size = stream->Size;
   

   VB복사

   Dim size = stream.Size
   

3. GetInputStreamAt 메서드를 호출하여 입력 스트림을 가져옵니다. 이를 using 문에 배치하여 스트림의 수명을 관리합니다. GetInputStreamAt을 호출할 때 0을 지정하여 위치를 스트림의 시작 부분으로 설정합니다.

   C#복사

   using (var inputStream = stream.GetInputStreamAt(0))
   {
       // We'll add more code here in the next step.
   }
   

   C++복사

   // Add after code from part 2
   IInputStream^ inputStream = stream->GetInputStreamAt(0);
   auto dataReader = ref new DataReader(inputStream);
   

   VB복사

   Using inputStream = stream.GetInputStreamAt(0)
       ' We'll add more code here in the next step.
   End Using
   

4. 마지막으로, 기존 using 문 내에 다음 코드를 추가하여 스트림에서 DataReader 개체를 가져온 다음 DataReader.LoadAsync 및 DataReader.ReadString를 호출하여 텍스트를 읽습니다.

   C#복사

   using (var dataReader = new Windows.Storage.Streams.DataReader(inputStream))
   {
       uint numBytesLoaded = await dataReader.LoadAsync((uint)size);
       string text = dataReader.ReadString(numBytesLoaded);
   }
   

   C++복사

   // Add after code from part 3
   create_task(dataReader->LoadAsync(size)).then([sampleFile, dataReader](unsigned int numBytesLoaded)
   {
       String^ streamText = dataReader->ReadString(numBytesLoaded);
   });
   

   VB복사

   Dim dataReader As New DataReader(inputStream)
   Dim numBytesLoaded As UInteger = Await dataReader.LoadAsync(CUInt(size))
   Dim text As String = dataReader.ReadString(numBytesLoaded)