ResourceWriter Třída

Reference

Definice

Obor názvů:: System.Resources

Sestavení:: System.Resources.Writer.dll

Sestavení:: netstandard.dll

Sestavení:: mscorlib.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 nemůže být zděděna.

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

Dědičnost: Object
ResourceWriter

Atributy: ComVisibleAttribute

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 binární soubor prostředků (.resources).

Prostředky se zadá jako páry název-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í a odstranit chyby, neumožňují, aby měl soubor .resources názvy, které se liší pouze velikostí ResourceWriter písmen. Třída ResourceWriter umožňuje vytvářet řetězcové, objektové a binární prostředky. Binární prostředky lze zapsat do souboru prostředků jako pole bajtů nebo datový proud.

Důležité

Tento typ implementuje IDisposable rozhraní . Jakmile budete s používáním typu hotovi, měli byste ho přímo nebo nepřímo zlikvidovat. Chcete-li vyřazení typu přímo, Dispose zavolejte jeho metodu v try / catch bloku. Pokud ho chcete nepřímo zlikvidovat, použijte jazykový konstruktor, například using (v jazyce C#) Using nebo (v Visual Basic). Další informace naleznete v části "Using an Object that Implements IDisposable" v IDisposable tématu rozhraní.

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

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

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

Konstruktory

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

Vlastnosti

TypeNameConverter

Získá nebo nastaví delegát, který umožňuje zápis sestavení prostředků, které cílové verze .NET Framework před .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é se mají zapsat.
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é se mají zapsat, a určuje, jestli se má datový proud po volání Generate() metody zavřít.
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 je zavře.
Dispose()	Umožňuje uživatelům zavřít soubor prostředků nebo datový proud, explicitně vydávané 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í funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro