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. Tej klasy nie można dziedziczyć.

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 (.resources).

Zasoby są określane jako pary nazw i wartości przy użyciu metody AddResource. Nazwy zasobów są wrażliwe na wielkość 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 używanie nazw, które różnią się tylko wielkością liter. Klasa ResourceWriter umożliwia tworzenie zasobów ciągów, obiektów i plików binarnych. Zasoby binarne można zapisywać w pliku zasobów jako tablicę bajtów lub strumień.

Ważny

Ten typ implementuje interfejs IDisposable. Po zakończeniu korzystania z typu należy usunąć go bezpośrednio lub pośrednio. Aby usunąć typ bezpośrednio, wywołaj metodę Dispose w bloku try/catch. Aby usunąć go pośrednio, należy użyć konstrukcji języka, 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 interfejs IDisposable) w temacie interfejsu IDisposable.

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

Zasoby nie muszą być zapisywane w tej samej kolejności, w której zostały dodane.

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

Konstruktory

ResourceWriter(Stream)	Inicjuje nowe wystąpienie klasy ResourceWriter, która zapisuje zasoby w podanym strumieniu.
ResourceWriter(String)	Inicjuje nowe wystąpienie klasy ResourceWriter, 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 mają być przeznaczone dla wersji programu .NET Framework przed programem .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, 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 wywołaniu metody Generate().
AddResource(String, Stream)	Dodaje nazwany zasób określony jako strumień do listy zasobów do zapisania.
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 lub strumienia zasobów, jawnie zwalniając zasoby.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
Generate()	Zapisuje wszystkie zasoby w strumieniu wyjściowym w domyślnym formacie systemu.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• IResourceWriter
• IDisposable
• zasoby w usłudze Desktop Apps
• tworzenie plików zasobów dla aplikacji klasycznych