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 не позволяет resources-файлу иметь имена, которые различаются только в зависимости от регистра. Класс ResourceWriter позволяет создавать строковые, объектные и двоичные ресурсы. Двоичные ресурсы могут быть записаны в файл ресурсов в виде массива байтов или потока.

Важно!

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

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

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

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

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

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

Свойства

TypeNameConverter

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

Методы

AddResource(String, Byte[])	Добавляет именованный ресурс, заданный в виде массива байтов, в список ресурсов для записи.
AddResource(String, Object)	Добавляет именованный ресурс, заданный в виде объекта, в список ресурсов для записи.
AddResource(String, Stream)	Добавляет именованный ресурс, заданный в виде потока, в список ресурсов для записи.
AddResource(String, Stream, Boolean)	Добавляет именованный ресурс, заданный как поток, в список ресурсов для записи и указывает, следует ли закрыть поток после вызова метода Generate().
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
• Ресурсы в приложениях для настольных систем
• Создание файлов ресурсов для приложений для настольных систем