MetadataReference.CreateFromImage Metodo
Definizione
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.
Overload
CreateFromImage(IEnumerable<Byte>, MetadataReferenceProperties, DocumentationProvider, String) |
Crea un riferimento a un assembly a modulo singolo o a un modulo autonomo archiviato in memoria. |
CreateFromImage(ImmutableArray<Byte>, MetadataReferenceProperties, DocumentationProvider, String) |
Crea un riferimento a un assembly a modulo singolo o a un modulo autonomo archiviato in memoria. |
CreateFromImage(IEnumerable<Byte>, MetadataReferenceProperties, DocumentationProvider, String)
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
Crea un riferimento a un assembly a modulo singolo o a un modulo autonomo archiviato in memoria.
public static Microsoft.CodeAnalysis.PortableExecutableReference CreateFromImage (System.Collections.Generic.IEnumerable<byte> peImage, Microsoft.CodeAnalysis.MetadataReferenceProperties properties = default, Microsoft.CodeAnalysis.DocumentationProvider documentation = default, string filePath = default);
public static Microsoft.CodeAnalysis.PortableExecutableReference CreateFromImage (System.Collections.Generic.IEnumerable<byte> peImage, Microsoft.CodeAnalysis.MetadataReferenceProperties properties = default, Microsoft.CodeAnalysis.DocumentationProvider? documentation = default, string? filePath = default);
static member CreateFromImage : seq<byte> * Microsoft.CodeAnalysis.MetadataReferenceProperties * Microsoft.CodeAnalysis.DocumentationProvider * string -> Microsoft.CodeAnalysis.PortableExecutableReference
Public Shared Function CreateFromImage (peImage As IEnumerable(Of Byte), Optional properties As MetadataReferenceProperties = Nothing, Optional documentation As DocumentationProvider = Nothing, Optional filePath As String = Nothing) As PortableExecutableReference
Parametri
- peImage
- IEnumerable<Byte>
Immagine dell'assembly.
- properties
- MetadataReferenceProperties
Proprietà di riferimento (alias extern, incorporamento dei tipi, MetadataImageKind).
- documentation
- DocumentationProvider
Fornisce la documentazione XML per il simbolo trovato nel riferimento.
- filePath
- String
Percorso facoltativo che descrive la posizione dei metadati. Il file non deve esistere su disco. Il percorso è opaco al compilatore.
Restituisce
Eccezioni
peImage
è null.
Commenti
Considerazioni sulle prestazioni:
È consigliabile usare o CreateFromImage(IEnumerable<Byte>) API CreateFromImage(IEnumerable<Byte>) quando si creano più riferimenti agli stessi metadati. Il riutilizzo dell'oggetto Metadata per creare più riferimenti consente di condividere i dati tra questi riferimenti.
Il metodo crea una copia dei dati e la aggiunge. Per evitare di creare una copia, usare un overload che accetta un oggetto ImmutableArray<T>. La memoria bloccata viene rilasciata quando il riferimento risultante diventa non raggiungibile e GC lo raccoglie. Per controllare la durata della memoria aggiunta in modo deterministico, usare CreateFromStream(Stream, PEStreamOptions) per creare un IDisposable oggetto metadati e GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) ottenere un riferimento.
Si applica a
CreateFromImage(ImmutableArray<Byte>, MetadataReferenceProperties, DocumentationProvider, String)
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
- Source:
- MetadataReference.cs
Crea un riferimento a un assembly a modulo singolo o a un modulo autonomo archiviato in memoria.
public static Microsoft.CodeAnalysis.PortableExecutableReference CreateFromImage (System.Collections.Immutable.ImmutableArray<byte> peImage, Microsoft.CodeAnalysis.MetadataReferenceProperties properties = default, Microsoft.CodeAnalysis.DocumentationProvider documentation = default, string filePath = default);
public static Microsoft.CodeAnalysis.PortableExecutableReference CreateFromImage (System.Collections.Immutable.ImmutableArray<byte> peImage, Microsoft.CodeAnalysis.MetadataReferenceProperties properties = default, Microsoft.CodeAnalysis.DocumentationProvider? documentation = default, string? filePath = default);
static member CreateFromImage : System.Collections.Immutable.ImmutableArray<byte> * Microsoft.CodeAnalysis.MetadataReferenceProperties * Microsoft.CodeAnalysis.DocumentationProvider * string -> Microsoft.CodeAnalysis.PortableExecutableReference
Public Shared Function CreateFromImage (peImage As ImmutableArray(Of Byte), Optional properties As MetadataReferenceProperties = Nothing, Optional documentation As DocumentationProvider = Nothing, Optional filePath As String = Nothing) As PortableExecutableReference
Parametri
- peImage
- ImmutableArray<Byte>
Immagine dell'assembly.
- properties
- MetadataReferenceProperties
Proprietà di riferimento (alias extern, incorporamento dei tipi, MetadataImageKind).
- documentation
- DocumentationProvider
Fornisce la documentazione XML per il simbolo trovato nel riferimento.
- filePath
- String
Percorso facoltativo che descrive la posizione dei metadati. Il file non deve esistere su disco. Il percorso è opaco al compilatore.
Restituisce
Eccezioni
peImage
è null.
Commenti
Considerazioni sulle prestazioni:
È consigliabile usare o CreateFromImage(ImmutableArray<Byte>) API CreateFromImage(ImmutableArray<Byte>) quando si creano più riferimenti agli stessi metadati. Il riutilizzo dell'oggetto Metadata per creare più riferimenti consente di condividere i dati tra questi riferimenti.
Il metodo aggiunge peImage
nell'heap gestito. La memoria bloccata viene rilasciata quando il riferimento risultante diventa non raggiungibile e GC lo raccoglie. Per controllare la durata della memoria aggiunta in modo deterministico, usare CreateFromImage(ImmutableArray<Byte>) per creare un IDisposable oggetto metadati e GetReference(DocumentationProvider, ImmutableArray<String>, Boolean, String, String) ottenere un riferimento.
Il metodo crea un riferimento a un assembly a modulo singolo. Per creare un riferimento a un assembly multimodulo o a un modulo autonomo, usare CreateFromImage(ImmutableArray<Byte>) e GetReference(DocumentationProvider, String, String).