ResourceWriter Classe

Definizione

Scrive le risorse in un file o flusso di output nel formato predefinito per il sistema.Writes resources in the system-default format to an output file or an output stream. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class ResourceWriter sealed : System::Resources::IResourceWriter
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ResourceWriter : System.Resources.IResourceWriter
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
Public NotInheritable Class ResourceWriter
Implements IResourceWriter
Ereditarietà
ResourceWriter
Attributi
Implementazioni

Esempi

Nell'esempio seguente vengono scritte diverse stringhe nel file MyResources. resources.The following example writes several strings into the myResources.resources file.

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

Commenti

ResourceWriterfornisce un'implementazione predefinita dell' IResourceWriter interfaccia.ResourceWriter provides a default implementation of the IResourceWriter interface. Consente di creare un file di risorse binario (con estensione resources) a livello di codice.It enables you to programmatically create a binary resource (.resources) file.

Le risorse vengono specificate come coppie nome/valore utilizzando AddResource il metodo.Resources are specified as name and value pairs using the AddResource method. I nomi delle risorse fanno distinzione tra maiuscole e minuscole quando vengono usati per le ricerche, ma per supportare più facilmente gli ResourceWriter strumenti di creazione e contribuire a eliminare i bug, non consente a un file con estensione resources di avere nomi che variano solo in base al caso.Resource names are case-sensitive when used for lookups, but to more easily support authoring tools and help eliminate bugs, ResourceWriter will not allow a .resources file to have names that vary only by case. La ResourceWriter classe consente di creare stringhe, oggetti e risorse binarie.The ResourceWriter class enables you to create string, object, and binary resources. Le risorse binarie possono essere scritte nel file di risorse come una matrice di byte o un flusso.Binary resources can be written to the resource file as a byte array or a stream.

Importante

Il tipo implementa l'interfaccia IDisposable.This type implements the IDisposable interface. Dopo aver utilizzato il tipo, è necessario eliminarlo direttamente o indirettamente.When you have finished using the type, you should dispose of it either directly or indirectly. Per eliminare direttamente il tipo, chiamare il metodo Dispose in un blocco try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Per eliminarlo indirettamente, utilizzare un costrutto di linguaggio come ad esempio using in C# o Using in Visual Basic.To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Per altre informazioni, vedere la sezione "Uso di un oggetto che implementa IDisposable" nell'argomento relativo all'interfaccia IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Per creare un file di risorse, creare ResourceWriter un con un nome file univoco, AddResource chiamare almeno una volta, Generate chiamare per scrivere il file di risorse su disco e quindi Close chiamare per chiudere il file.To create a resources file, create a ResourceWriter with a unique file name, call AddResource at least once, call Generate to write the resources file to disk, and then call Close to close the file. La Close chiamata a chiamerà implicitamente Generate se non si chiama Generatein modo esplicito.Calling Close will implicitly call Generate if you do not explicitly call Generate.

Le risorse non verranno necessariamente scritte nello stesso ordine in cui sono state aggiunte.The resources will not necessarily be written in the same order they were added.

Per recuperare le risorse da un file con estensione resources ResourceWriter binario creato dalla classe, è ResourceManager possibile usare la classe, che consente di recuperare le risorse ResourceReader denominate o la classe, che consente di enumerare tutte le risorse nel file.To retrieve resources from a binary .resources file created by the ResourceWriter class, you can use the ResourceManager class, which lets you retrieve named resources, or the ResourceReader class, which lets you enumerate all the resources in the file.

Costruttori

ResourceWriter(Stream)

Inizializza una nuova istanza della classe ResourceWriter che scrive le risorse nel flusso fornito.Initializes a new instance of the ResourceWriter class that writes the resources to the provided stream.

ResourceWriter(String)

Inizializza una nuova istanza della classe ResourceWriter che scrive le risorse nel file specificato.Initializes a new instance of the ResourceWriter class that writes the resources to the specified file.

Proprietà

TypeNameConverter

Ottiene o imposta un delegato che consente la scrittura di assembly di risorse per le versioni di .NET Framework antecedenti a .NET Framework 4.NET Framework 4 usando nomi di assembly completi.Gets or sets a delegate that enables resource assemblies to be written that target versions of the .NET Framework prior to the .NET Framework 4.NET Framework 4 by using qualified assembly names.

Metodi

AddResource(String, Byte[])

Aggiunge all'elenco di risorse da scrivere una risorsa denominata specificata come matrice di byte.Adds a named resource specified as a byte array to the list of resources to be written.

AddResource(String, Object)

Aggiunge all'elenco di risorse da scrivere una risorsa denominata specificata come oggetto.Adds a named resource specified as an object to the list of resources to be written.

AddResource(String, Stream)

Aggiunge all'elenco di risorse da scrivere una risorsa denominata specificata come flusso.Adds a named resource specified as a stream to the list of resources to be written.

AddResource(String, Stream, Boolean)

Aggiunge all'elenco di risorse da scrivere una risorsa denominata specificata come flusso e specifica se il flusso deve essere chiuso dopo la chiamata al metodo Generate().Adds a named resource specified as a stream to the list of resources to be written, and specifies whether the stream should be closed after the Generate() method is called.

AddResource(String, String)

Aggiunge una risorsa di tipo stringa all'elenco di risorse da scrivere.Adds a string resource to the list of resources to be written.

AddResourceData(String, String, Byte[])

Aggiunge un'unità di dati come risorsa all'elenco di risorse da scrivere.Adds a unit of data as a resource to the list of resources to be written.

Close()

Salva le risorse nel flusso di output e lo chiude.Saves the resources to the output stream and then closes it.

Dispose()

Consente agli utenti di chiudere il flusso o il file di risorsa, rilasciando le risorse in modo esplicito.Allows users to close the resource file or stream, explicitly releasing resources.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Generate()

Salva tutte le risorse nel flusso di output nel formato predefinito per il sistema.Saves all resources to the output stream in the system default format.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche