ResourceWriter Класс

Ссылка

Определение

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

Сборка:: System.Resources.Writer.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

public ref class ResourceWriter sealed : IDisposable

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

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

public sealed class ResourceWriter : IDisposable

public sealed class ResourceWriter : System.Resources.IResourceWriter

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ResourceWriter : System.Resources.IResourceWriter

type ResourceWriter = class
    interface IDisposable
    interface IResourceWriter

type ResourceWriter = class
    interface IDisposable

type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable

[<System.Runtime.InteropServices.ComVisible(true)>]
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable

Public NotInheritable Class ResourceWriter
Implements IDisposable, IResourceWriter

Public NotInheritable Class ResourceWriter
Implements IDisposable

Public NotInheritable Class ResourceWriter
Implements IResourceWriter

Наследование: Object
ResourceWriter

Атрибуты: ComVisibleAttribute

Реализации: 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

Ресурсы указываются в виде пар "имя" и "значение" AddResource с помощью метода. Имена ресурсов чувствительны к регистру при использовании для подстановок, но для более простой поддержки средств разработки и устранения ошибок не позволяют файлу RESOURCES иметь имена, ResourceWriter которые различаются только в зависимости от регистра. Этот 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)

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