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. Tato třída se nemůže dě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 IResourceWriter rozhraní. Umožňuje programově vytvořit soubor binárního prostředku (.resources).

Prostředky se zadají jako páry název a hodnota pomocí AddResource metody . V názvech prostředků se při vyhledávání rozlišují malá a velká písmena, ale pokud chcete snadněji podporovat nástroje pro vytváření obsahu a odstranit chyby, ResourceWriter neumožníte, aby soubor .resources měl názvy, které se liší pouze podle velkých a malých písmen. Třída ResourceWriter umožňuje vytvářet řetězcové, objektové a binární prostředky. Binární prostředky mohou být zapsány do souboru prostředků jako pole bajtů nebo datový proud.

Důležité

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

Chcete-li vytvořit soubor prostředků, vytvořte ResourceWriter soubor s jedinečným názvem, zavolejte AddResource alespoň jednou, zavolejte Generate metodu pro zápis souboru prostředků na disk a pak voláním zavřete Close soubor. Volání Close bude implicitně volat Generate , pokud explicitně nevoláte Generate.

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

K načtení prostředků z binárního souboru .resources vytvořeného ResourceWriter třídou můžete použít ResourceManager třídu , která umožňuje načíst pojmenované prostředky, nebo ResourceReader třídu , 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 zadané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áta, který umožňuje zápis sestavení prostředků 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 zadaný 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é mají být zapsány.
AddResource(String, Stream)	Přidá pojmenovaný prostředek zadaný jako datový proud 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é mají být zapsány, a určuje, zda má být datový proud uzavřen po Generate() zavolání metody.
AddResource(String, String)	Přidá řetězcový prostředek 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čí, zda se zadaný objekt rovná 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 systémovém formátu.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (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í zdrojových souborů pro aplikace klasické pracovní plochy