ResourceWriter Třída

Definice

Obor názvů:

System.Resources

Sestavení:

netstandard.dll, 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 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 dvojice 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 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ězce, objekty a binární prostředky. Binární prostředky lze zapisovat do souboru prostředků jako pole bajtů nebo streamu.

Important

Tento typ implementuje rozhraní IDisposable. Jakmile skončíte s používáním typu, 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 IDisposable tématu rozhraní.

Pokud chcete vytvořit soubor prostředků, vytvořte soubor s jedinečným ResourceWriter názvem, zavolejte AddResource alespoň jednou, zavolejte Generate soubor prostředků na disk a pak voláním Close zavřete soubor. Volání Close bude implicitně volat 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 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

Name	Description
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

Name	Description
TypeNameConverter	Získá nebo nastaví delegáta, který umožňuje sestavení prostředků být zapsána, že cílové verze .NET Framework před .NET Framework 4 pomocí kvalifikovaných názvů sestavení.

Metody

Name	Description
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 Generate() zavolání metody.
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