ResourceWriter Třída

Definice

Obor názvů:

System.Resources

Sestavení:

System.Resources.Writer.dll

Zdroj:

ResourceWriter.cs

Zapisuje prostředky ve výchozím systémovém formátu do výstupního souboru nebo výstupního datového proudu. Tuto třídu nelze zdědit.

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

Dědičnost

Object

ResourceWriter

Implementuje

IDisposable IResourceWriter

Příklady

Následující příklad zapíše několik řetězců do souboru 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

Poznámky

ResourceWriter poskytuje výchozí implementaci rozhraní IResourceWriter. Umožňuje programově vytvořit soubor binárního prostředku (.resources).

Prostředky se zadají jako páry název a hodnota pomocí metody AddResource. V názvech prostředků se při vyhledávání rozlišují malá a velká písmena, ale aby se snadněji podporovaly nástroje pro vytváření obsahu a pomohly odstranit chyby, ResourceWriter nedovolí, aby soubor .resources měl názvy, které se liší pouze v jednotlivých případech. Třída ResourceWriter umožňuje vytvářet řetězcové, objektové a binární prostředky. Binární prostředky lze zapisovat do souboru prostředků jako pole bajtů nebo streamu.

Důležitý

Tento typ implementuje rozhraní IDisposable. Jakmile typ dokončíte, měli byste ho odstranit buď přímo, nebo nepřímo. Chcete-li typ odstranit přímo, zavolejte jeho Dispose metodu v bloku try/catch. Pokud ho chcete zlikvidovat nepřímo, použijte konstruktor jazyka, jako je using (v jazyce C#) nebo Using (v jazyce Visual Basic). Další informace naleznete v části Použití objektu, který implementuje IDisposable v tématu IDisposable rozhraní.

Pokud chcete vytvořit soubor prostředků, vytvořte ResourceWriter s jedinečným názvem souboru, zavolejte AddResource alespoň jednou, zavolejte Generate zapište soubor prostředků na disk a potom zavolejte Close zavřete soubor. Volání Close implicitně zavolá Generate, pokud explicitně nezavoláte Generate.

Prostředky nemusí být nutně zapsány ve stejném pořadí, v jakém byly přidány.

Pokud chcete načíst prostředky z binárního souboru .resources vytvořeného ResourceWriter třídou, můžete použít třídu ResourceManager, která umožňuje načíst pojmenované prostředky nebo třídu ResourceReader, která umožňuje vytvořit výčet všech prostředků v souboru.

Konstruktory

ResourceWriter(Stream)	Inicializuje novou instanci ResourceWriter třídy, která zapisuje prostředky do poskytnutého datového proudu.
ResourceWriter(String)	Inicializuje novou instanci ResourceWriter třídy, která zapisuje prostředky do zadaného souboru.

Vlastnosti

TypeNameConverter

Získá nebo nastaví delegát, který umožňuje sestavení prostředků zapisovat, že cílové verze rozhraní .NET Framework před rozhraním .NET Framework 4 pomocí kvalifikovaných názvů sestavení.

Metody

AddResource(String, Byte[])	Přidá pojmenovaný prostředek určený jako pole bajtů do seznamu prostředků, které se mají zapsat.
AddResource(String, Object)	Přidá pojmenovaný prostředek zadaný jako objekt do seznamu prostředků, které se mají zapsat.
AddResource(String, Stream, Boolean)	Přidá pojmenovaný prostředek zadaný jako datový proud do seznamu prostředků, které se mají zapsat, a určuje, zda má být datový proud uzavřen po zavolání metody Generate().
AddResource(String, Stream)	Přidá pojmenovaný prostředek zadaný jako datový proud do seznamu prostředků, které se mají zapsat.
AddResource(String, String)	Přidá prostředek řetězce do seznamu prostředků, které se mají zapsat.
AddResourceData(String, String, Byte[])	Přidá jednotku dat jako prostředek do seznamu prostředků, které se mají zapsat.
Close()	Uloží prostředky do výstupního datového proudu a pak ho zavře.
Dispose()	Umožňuje uživatelům zavřít soubor prostředků nebo datový proud a explicitně uvolnit prostředky.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Generate()	Uloží všechny prostředky do výstupního datového proudu ve výchozím formátu systému.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• IResourceWriter
• IDisposable
• prostředky v desktopových aplikacích
• vytváření souborů prostředků pro desktopové aplikace