ResourceWriter Klasa

Definicja

Przestrzeń nazw:

System.Resources

Zestaw:

System.Resources.Writer.dll

Źródło:

ResourceWriter.cs

Zapisuje zasoby w formacie domyślnym systemu do pliku wyjściowego lub strumienia wyjściowego. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

ResourceWriter

Implementuje

IDisposable IResourceWriter

Przykłady

Poniższy przykład zapisuje kilka ciągów w pliku 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

Uwagi

ResourceWriter Zapewnia domyślną implementację interfejsu IResourceWriter . Umożliwia programowe tworzenie pliku zasobu binarnego (zasobów).

Zasoby są określane jako pary nazw i wartości przy użyciu AddResource metody . Nazwy zasobów są uwzględniane wielkości liter w przypadku wyszukiwania, ale aby łatwiej obsługiwać narzędzia do tworzenia i pomóc wyeliminować błędy, ResourceWriter nie pozwoli plikowi resources na nazwy, które różnią się tylko wielkością liter. Klasa ResourceWriter umożliwia tworzenie zasobów ciągowych, obiektów i binarnych. Zasoby binarne można zapisywać w pliku zasobów jako tablicę bajtów lub strumień.

Ważne

Ten typ implementuje IDisposable interfejs. Po zakończeniu korzystania z typu należy go usunąć bezpośrednio lub pośrednio. Aby usunąć typ bezpośrednio, wywołaj metodę Disposetry/catch w bloku. Aby usunąć go pośrednio, użyj konstrukcji językowej, takiej jak using (w języku C#) lub Using (w Visual Basic). Aby uzyskać więcej informacji, zobacz sekcję "Using an Object that Implements IDisposable" (Używanie obiektu implementujące protokół IDisposable) w temacie interfejsu IDisposable .

Aby utworzyć plik zasobów, utwórz ResourceWriter element o unikatowej nazwie pliku, wywołaj AddResource co najmniej raz, wywołaj polecenie Generate , aby zapisać plik zasobów na dysku, a następnie wywołaj polecenie Close , aby zamknąć plik. Wywołanie Close będzie niejawnie wywoływane Generate , jeśli nie wywołasz jawnie metody Generate.

Zasoby niekoniecznie będą zapisywane w tej samej kolejności, w której zostały dodane.

Aby pobrać zasoby z binarnego pliku resources utworzonego przez ResourceWriter klasę, możesz użyć ResourceManager klasy , która umożliwia pobranie nazwanych zasobów lub ResourceReader klasy, która umożliwia wyliczenie wszystkich zasobów w pliku.

Konstruktory

ResourceWriter(Stream)	Inicjuje ResourceWriter nowe wystąpienie klasy, która zapisuje zasoby w podanym strumieniu.
ResourceWriter(String)	Inicjuje ResourceWriter nowe wystąpienie klasy, która zapisuje zasoby w określonym pliku.

Właściwości

TypeNameConverter

Pobiera lub ustawia delegata, który umożliwia zapisanie zestawów zasobów, które są przeznaczone dla wersji .NET Framework przed .NET Framework 4 przy użyciu kwalifikowanych nazw zestawów.

Metody

AddResource(String, Byte[])	Dodaje nazwany zasób określony jako tablica bajtów do listy zasobów do zapisania.
AddResource(String, Object)	Dodaje nazwany zasób określony jako obiekt do listy zasobów do zapisania.
AddResource(String, Stream)	Dodaje nazwany zasób określony jako strumień do listy zasobów do zapisania.
AddResource(String, Stream, Boolean)	Dodaje nazwany zasób określony jako strumień do listy zasobów do zapisania i określa, czy strumień powinien zostać zamknięty po Generate() wywołaniu metody.
AddResource(String, String)	Dodaje zasób ciągu do listy zasobów do zapisania.
AddResourceData(String, String, Byte[])	Dodaje jednostkę danych jako zasób do listy zasobów do zapisania.
Close()	Zapisuje zasoby w strumieniu wyjściowym, a następnie zamyka je.
Dispose()	Umożliwia użytkownikom zamknięcie pliku zasobu lub strumienia, jawnie zwalniając zasoby.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Generate()	Zapisuje wszystkie zasoby w strumieniu wyjściowym w formacie domyślnym systemu.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• IResourceWriter
• IDisposable
• Zasoby w aplikacjach klasycznych
• Tworzenie plików zasobów dla aplikacji klasycznych