Прочитать на английском

Поделиться через


ResourceWriter Класс

Определение

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

C#
public sealed class ResourceWriter : IDisposable, System.Resources.IResourceWriter
C#
public sealed class ResourceWriter : IDisposable
C#
public sealed class ResourceWriter : System.Resources.IResourceWriter
C#
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ResourceWriter : System.Resources.IResourceWriter
Наследование
ResourceWriter
Атрибуты
Реализации

Примеры

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

C#
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();
   }
}

Комментарии

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)

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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