ResourceWriter Classe

Riferimento

Definizione

Spazio dei nomi:: System.Resources

Assembly:: System.Resources.Writer.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 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

Ereditarietà: Object
ResourceWriter

Attributi: ComVisibleAttribute

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 IResourceWriter dell'interfaccia . Consente di creare a livello di codice un file di risorse binario (con estensione resources).

Le risorse vengono specificate come coppie nome/valore usando il AddResource metodo . I nomi delle risorse supportano la distinzione tra maiuscole e minuscole quando vengono usati per le ricerche, ma per supportare più facilmente gli strumenti di creazione e per eliminare i bug, non consentirà a un file con estensione resources di avere nomi che variano solo in base alla distinzione tra maiuscole e ResourceWriter minuscole. La ResourceWriter classe consente di creare risorse stringa, oggetto e binaria. 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 oggetto con un nome file univoco, chiamare almeno una volta, chiamare per scrivere il file di risorse su disco e quindi chiamare per ResourceWriter AddResource chiudere il Generate Close file. La Close chiamata di chiamerà in modo Generate implicito se non si chiama in modo esplicito Generate .

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

Per recuperare risorse da un file binario con estensione resources creato dalla classe , è possibile usare la classe , che consente di recuperare le risorse denominate, o la classe , che consente di enumerare tutte le ResourceWriter ResourceManager risorse nel ResourceReader 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)

Si applica a