ResourceWriter Класс

Определение

Пространство имен:

System.Resources

Сборка:

System.Resources.Writer.dll

Исходный код:

ResourceWriter.cs

Записывает ресурсы в системный формат по умолчанию в выходной файл или выходной поток. Этот класс не может быть унаследован.

public ref class ResourceWriter sealed : IDisposable, System::Resources::IResourceWriter

public sealed class ResourceWriter : IDisposable, System.Resources.IResourceWriter

type ResourceWriter = class
    interface IDisposable
    interface IResourceWriter

Public NotInheritable Class ResourceWriter
Implements IDisposable, IResourceWriter

Наследование

Object

ResourceWriter

Реализации

IDisposable IResourceWriter

Примеры

В следующем примере записывается несколько строк в файл myResources.resources.

using namespace System;
using namespace System::Resources;
int main()
{
   
   // Creates a resource writer.
   IResourceWriter^ writer = gcnew ResourceWriter( "myResources.resources" );
   
   // Adds resources to the resource writer.
   writer->AddResource( "String 1", "First String" );
   writer->AddResource( "String 2", "Second String" );
   writer->AddResource( "String 3", "Third String" );
   
   // Writes the resources to the file or stream, and closes it.
   writer->Close();
}

using System;
using System.Resources;

public class WriteResources {
   public static void Main(string[] args) {

      // Creates a resource writer.
      IResourceWriter writer = new ResourceWriter("myResources.resources");

      // Adds resources to the resource writer.
      writer.AddResource("String 1", "First String");

      writer.AddResource("String 2", "Second String");

      writer.AddResource("String 3", "Third String");

      // Writes the resources to the file or stream, and closes it.
      writer.Close();
   }
}

Imports System.Resources

Public Class WriteResources
    
    Public Shared Sub Main()
        
        ' Creates a resource writer.
        Dim writer As New ResourceWriter("myResources.resources")
        
        ' Adds resources to the resource writer.
        writer.AddResource("String 1", "First String")
        
        writer.AddResource("String 2", "Second String")
        
        writer.AddResource("String 3", "Third String")
        
        ' Writes the resources to the file or stream, and closes it.
        writer.Close()
    End Sub
End Class

Комментарии

ResourceWriter предоставляет реализацию интерфейса IResourceWriter по умолчанию. Он позволяет программным способом создать двоичный файл ресурса (.resources).

Ресурсы указываются как пары имен и значений с помощью метода AddResource. Имена ресурсов чувствительны к регистру при использовании для подстановок, но для упрощения поддержки средств разработки и устранения ошибок, ResourceWriter не позволит файлу ресурсов иметь имена, которые зависят только по регистру. Класс ResourceWriter позволяет создавать строковые, объектные и двоичные ресурсы. Двоичные ресурсы можно записать в файл ресурса в виде массива байтов или потока.

Важный

Этот тип реализует интерфейс IDisposable. Завершив использование типа, его следует удалить напрямую или косвенно. Чтобы удалить тип напрямую, вызовите метод Dispose в блоке try/catch. Чтобы удалить его косвенно, используйте конструкцию языка, например using (в C#) или Using (в Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" в разделе интерфейса IDisposable.

Чтобы создать файл ресурсов, создайте ResourceWriter с уникальным именем файла, вызовите AddResource по крайней мере один раз, вызовите Generate для записи файла ресурсов на диск, а затем вызовите Close, чтобы закрыть файл. Вызов Close неявно вызывает Generate, если явно не вызывать Generate.

Ресурсы не обязательно записываются в том же порядке, что и они были добавлены.

Чтобы получить ресурсы из двоичного файла ресурсов, созданного классом ResourceWriter, можно использовать класс ResourceManager, который позволяет извлекать именованные ресурсы или класс ResourceReader, который позволяет перечислять все ресурсы в файле.

Конструкторы

ResourceWriter(Stream)	Инициализирует новый экземпляр класса ResourceWriter, который записывает ресурсы в предоставленный поток.
ResourceWriter(String)	Инициализирует новый экземпляр класса ResourceWriter, который записывает ресурсы в указанный файл.

Свойства

TypeNameConverter

Возвращает или задает делегат, позволяющий записывать сборки ресурсов, предназначенные для .NET Framework до .NET Framework 4, используя полные имена сборок.

Методы

AddResource(String, Byte[])	Добавляет именованный ресурс, указанный как массив байтов, в список ресурсов для записи.
AddResource(String, Object)	Добавляет именованный ресурс, указанный как объект, в список ресурсов для записи.
AddResource(String, Stream, Boolean)	Добавляет именованный ресурс, указанный как поток, в список ресурсов для записи, и указывает, следует ли закрывать поток после вызова метода Generate().
AddResource(String, Stream)	Добавляет именованный ресурс, указанный как поток, в список ресурсов для записи.
AddResource(String, String)	Добавляет строковый ресурс в список ресурсов для записи.
AddResourceData(String, String, Byte[])	Добавляет единицу данных в список ресурсов, которые необходимо записать.
Close()	Сохраняет ресурсы в выходной поток, а затем закрывает его.
Dispose()	Позволяет пользователям закрыть файл ресурсов или поток, явно освобождая ресурсы.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Generate()	Сохраняет все ресурсы в выходном потоке в системном формате по умолчанию.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• IResourceWriter
• IDisposable
• ресурсы в классических приложениях
• создание файлов ресурсов для классических приложений