ResourceWriter Classe

Definizione

Spazio dei nomi:

System.Resources

Assembly:

System.Resources.Writer.dll

Origine:

ResourceWriter.cs

Scrive le risorse in un file o flusso di output nel formato predefinito per il sistema. La classe non può essere ereditata.

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

Ereditarietà

Object

ResourceWriter

Implementazioni

IDisposable IResourceWriter

Esempio

L'esempio seguente scrive diverse stringhe nel file 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

Commenti

ResourceWriter fornisce un'implementazione predefinita dell'interfaccia IResourceWriter . Consente di creare a livello di codice un file di risorse binarie (con estensione resources).

Le risorse vengono specificate come coppie nome e valore usando il AddResource metodo . I nomi delle risorse fanno distinzione tra maiuscole e minuscole quando vengono usati per le ricerche, ma per supportare più facilmente gli strumenti di creazione ed eliminare i bug, ResourceWriter non consentirà a un file con estensione resources di avere nomi che variano solo in base al caso. La ResourceWriter classe consente di creare risorse stringa, oggetto e binario. Le risorse binarie possono essere scritte nel file di risorse come matrice di byte o flusso.

Importante

Il tipo implementa l'interfaccia IDisposable. Dopo aver utilizzato il tipo, è necessario eliminarlo direttamente o indirettamente. Per eliminare direttamente il tipo, chiamare il metodo Dispose in un blocco try/catch. Per eliminarlo indirettamente, utilizzare un costrutto di linguaggio come ad esempio using in C# o Using in Visual Basic. Per altre informazioni, vedere la sezione "Uso di un oggetto che implementa IDisposable" nell'argomento relativo all'interfaccia IDisposable.

Per creare un file di risorse, creare un ResourceWriter oggetto con un nome file univoco, chiamare AddResource almeno una volta, chiamare Generate per scrivere il file di risorse su disco e quindi chiamare Close per chiudere il file. La chiamata Close verrà chiamata Generate in modo implicito se non si chiama Generatein modo esplicito .

Le risorse non verranno necessariamente scritte nello stesso ordine in cui sono state aggiunte.

Per recuperare le risorse da un file binario con estensione resources creato dalla ResourceWriter classe , è possibile usare la ResourceManager classe , che consente di recuperare le risorse denominate o la ResourceReader classe , che consente di enumerare tutte le risorse nel file.

Costruttori

ResourceWriter(Stream)	Inizializza una nuova istanza della classe ResourceWriter che scrive le risorse nel flusso fornito.
ResourceWriter(String)	Inizializza una nuova istanza della classe ResourceWriter che scrive le risorse nel file specificato.

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 usando nomi di assembly completi.

Metodi

AddResource(String, Byte[])	Aggiunge all'elenco di risorse da scrivere una risorsa denominata specificata come matrice di byte.
AddResource(String, Object)	Aggiunge all'elenco di risorse da scrivere una risorsa denominata specificata come oggetto.
AddResource(String, Stream)	Aggiunge all'elenco di risorse da scrivere una risorsa denominata specificata come flusso.
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().
AddResource(String, String)	Aggiunge una risorsa di tipo stringa all'elenco di risorse da scrivere.
AddResourceData(String, String, Byte[])	Aggiunge un'unità di dati come risorsa all'elenco di risorse da scrivere.
Close()	Salva le risorse nel flusso di output e lo chiude.
Dispose()	Consente agli utenti di chiudere il flusso o il file di risorsa, rilasciando le risorse in modo esplicito.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Generate()	Salva tutte le risorse nel flusso di output nel formato predefinito per il sistema.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• IResourceWriter
• IDisposable
• Risorse nelle app desktop
• Creazione di file di risorse per applicazioni desktop