Compilation.Emit Methode

Definition

Namespace:

Microsoft.CodeAnalysis

Assembly:

Microsoft.CodeAnalysis.dll

Paket:

Microsoft.CodeAnalysis.Common v4.9.2

Überlädt

Emit(Stream, Stream, Stream, Stream, IEnumerable<ResourceDescription>, EmitOptions, CancellationToken)
Emit(Stream, Stream, Stream, Stream, IEnumerable<ResourceDescription>, EmitOptions, IMethodSymbol, CancellationToken)
Emit(Stream, Stream, Stream, Stream, IEnumerable<ResourceDescription>, EmitOptions, IMethodSymbol, Stream, IEnumerable<EmbeddedText>, CancellationToken)
Emit(Stream, Stream, Stream, Stream, IEnumerable<ResourceDescription>, EmitOptions, IMethodSymbol, Stream, IEnumerable<EmbeddedText>, Stream, CancellationToken)	Geben Sie die IL für den kompilierten Quellcode in den angegebenen Datenstrom aus.

Emit(Stream, Stream, Stream, Stream, IEnumerable<ResourceDescription>, EmitOptions, CancellationToken)

Source:

Compilation.cs

public:
 Microsoft::CodeAnalysis::Emit::EmitResult ^ Emit(System::IO::Stream ^ peStream, System::IO::Stream ^ pdbStream, System::IO::Stream ^ xmlDocumentationStream, System::IO::Stream ^ win32Resources, System::Collections::Generic::IEnumerable<Microsoft::CodeAnalysis::ResourceDescription ^> ^ manifestResources, Microsoft::CodeAnalysis::Emit::EmitOptions ^ options, System::Threading::CancellationToken cancellationToken);

[System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
public Microsoft.CodeAnalysis.Emit.EmitResult Emit (System.IO.Stream peStream, System.IO.Stream? pdbStream, System.IO.Stream? xmlDocumentationStream, System.IO.Stream? win32Resources, System.Collections.Generic.IEnumerable<Microsoft.CodeAnalysis.ResourceDescription>? manifestResources, Microsoft.CodeAnalysis.Emit.EmitOptions options, System.Threading.CancellationToken cancellationToken);

[<System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)>]
member this.Emit : System.IO.Stream * System.IO.Stream * System.IO.Stream * System.IO.Stream * seq<Microsoft.CodeAnalysis.ResourceDescription> * Microsoft.CodeAnalysis.Emit.EmitOptions * System.Threading.CancellationToken -> Microsoft.CodeAnalysis.Emit.EmitResult

Public Function Emit (peStream As Stream, pdbStream As Stream, xmlDocumentationStream As Stream, win32Resources As Stream, manifestResources As IEnumerable(Of ResourceDescription), options As EmitOptions, cancellationToken As CancellationToken) As EmitResult

Parameter

peStream

Stream

pdbStream

Stream

xmlDocumentationStream

Stream

win32Resources

Stream

manifestResources

IEnumerable<ResourceDescription>

options

EmitOptions

cancellationToken

CancellationToken

Gibt zurück

EmitResult

Attribute

EditorBrowsableAttribute

Emit(Stream, Stream, Stream, Stream, IEnumerable<ResourceDescription>, EmitOptions, IMethodSymbol, CancellationToken)

Source:

Compilation.cs

public:
 Microsoft::CodeAnalysis::Emit::EmitResult ^ Emit(System::IO::Stream ^ peStream, System::IO::Stream ^ pdbStream, System::IO::Stream ^ xmlDocumentationStream, System::IO::Stream ^ win32Resources, System::Collections::Generic::IEnumerable<Microsoft::CodeAnalysis::ResourceDescription ^> ^ manifestResources, Microsoft::CodeAnalysis::Emit::EmitOptions ^ options, Microsoft::CodeAnalysis::IMethodSymbol ^ debugEntryPoint, System::Threading::CancellationToken cancellationToken);

[System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
public Microsoft.CodeAnalysis.Emit.EmitResult Emit (System.IO.Stream peStream, System.IO.Stream pdbStream, System.IO.Stream xmlDocumentationStream, System.IO.Stream win32Resources, System.Collections.Generic.IEnumerable<Microsoft.CodeAnalysis.ResourceDescription> manifestResources, Microsoft.CodeAnalysis.Emit.EmitOptions options, Microsoft.CodeAnalysis.IMethodSymbol debugEntryPoint, System.Threading.CancellationToken cancellationToken);

[<System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)>]
member this.Emit : System.IO.Stream * System.IO.Stream * System.IO.Stream * System.IO.Stream * seq<Microsoft.CodeAnalysis.ResourceDescription> * Microsoft.CodeAnalysis.Emit.EmitOptions * Microsoft.CodeAnalysis.IMethodSymbol * System.Threading.CancellationToken -> Microsoft.CodeAnalysis.Emit.EmitResult

Public Function Emit (peStream As Stream, pdbStream As Stream, xmlDocumentationStream As Stream, win32Resources As Stream, manifestResources As IEnumerable(Of ResourceDescription), options As EmitOptions, debugEntryPoint As IMethodSymbol, cancellationToken As CancellationToken) As EmitResult

Parameter

peStream

Stream

pdbStream

Stream

xmlDocumentationStream

Stream

win32Resources

Stream

manifestResources

IEnumerable<ResourceDescription>

options

EmitOptions

debugEntryPoint

IMethodSymbol

cancellationToken

CancellationToken

Gibt zurück

EmitResult

Attribute

EditorBrowsableAttribute

Emit(Stream, Stream, Stream, Stream, IEnumerable<ResourceDescription>, EmitOptions, IMethodSymbol, Stream, IEnumerable<EmbeddedText>, CancellationToken)

Source:

Compilation.cs

public:
 Microsoft::CodeAnalysis::Emit::EmitResult ^ Emit(System::IO::Stream ^ peStream, System::IO::Stream ^ pdbStream, System::IO::Stream ^ xmlDocumentationStream, System::IO::Stream ^ win32Resources, System::Collections::Generic::IEnumerable<Microsoft::CodeAnalysis::ResourceDescription ^> ^ manifestResources, Microsoft::CodeAnalysis::Emit::EmitOptions ^ options, Microsoft::CodeAnalysis::IMethodSymbol ^ debugEntryPoint, System::IO::Stream ^ sourceLinkStream, System::Collections::Generic::IEnumerable<Microsoft::CodeAnalysis::EmbeddedText ^> ^ embeddedTexts, System::Threading::CancellationToken cancellationToken);

public Microsoft.CodeAnalysis.Emit.EmitResult Emit (System.IO.Stream peStream, System.IO.Stream? pdbStream, System.IO.Stream? xmlDocumentationStream, System.IO.Stream? win32Resources, System.Collections.Generic.IEnumerable<Microsoft.CodeAnalysis.ResourceDescription>? manifestResources, Microsoft.CodeAnalysis.Emit.EmitOptions options, Microsoft.CodeAnalysis.IMethodSymbol? debugEntryPoint, System.IO.Stream? sourceLinkStream, System.Collections.Generic.IEnumerable<Microsoft.CodeAnalysis.EmbeddedText>? embeddedTexts, System.Threading.CancellationToken cancellationToken);

member this.Emit : System.IO.Stream * System.IO.Stream * System.IO.Stream * System.IO.Stream * seq<Microsoft.CodeAnalysis.ResourceDescription> * Microsoft.CodeAnalysis.Emit.EmitOptions * Microsoft.CodeAnalysis.IMethodSymbol * System.IO.Stream * seq<Microsoft.CodeAnalysis.EmbeddedText> * System.Threading.CancellationToken -> Microsoft.CodeAnalysis.Emit.EmitResult

Public Function Emit (peStream As Stream, pdbStream As Stream, xmlDocumentationStream As Stream, win32Resources As Stream, manifestResources As IEnumerable(Of ResourceDescription), options As EmitOptions, debugEntryPoint As IMethodSymbol, sourceLinkStream As Stream, embeddedTexts As IEnumerable(Of EmbeddedText), cancellationToken As CancellationToken) As EmitResult

Parameter

peStream

Stream

pdbStream

Stream

xmlDocumentationStream

Stream

win32Resources

Stream

manifestResources

IEnumerable<ResourceDescription>

options

EmitOptions

debugEntryPoint

IMethodSymbol

sourceLinkStream

Stream

embeddedTexts

IEnumerable<EmbeddedText>

cancellationToken

CancellationToken

Gibt zurück

EmitResult

Emit(Stream, Stream, Stream, Stream, IEnumerable<ResourceDescription>, EmitOptions, IMethodSymbol, Stream, IEnumerable<EmbeddedText>, Stream, CancellationToken)

Source:

Compilation.cs

Geben Sie die IL für den kompilierten Quellcode in den angegebenen Datenstrom aus.

public Microsoft.CodeAnalysis.Emit.EmitResult Emit (System.IO.Stream peStream, System.IO.Stream? pdbStream = default, System.IO.Stream? xmlDocumentationStream = default, System.IO.Stream? win32Resources = default, System.Collections.Generic.IEnumerable<Microsoft.CodeAnalysis.ResourceDescription>? manifestResources = default, Microsoft.CodeAnalysis.Emit.EmitOptions? options = default, Microsoft.CodeAnalysis.IMethodSymbol? debugEntryPoint = default, System.IO.Stream? sourceLinkStream = default, System.Collections.Generic.IEnumerable<Microsoft.CodeAnalysis.EmbeddedText>? embeddedTexts = default, System.IO.Stream? metadataPEStream = default, System.Threading.CancellationToken cancellationToken = default);

member this.Emit : System.IO.Stream * System.IO.Stream * System.IO.Stream * System.IO.Stream * seq<Microsoft.CodeAnalysis.ResourceDescription> * Microsoft.CodeAnalysis.Emit.EmitOptions * Microsoft.CodeAnalysis.IMethodSymbol * System.IO.Stream * seq<Microsoft.CodeAnalysis.EmbeddedText> * System.IO.Stream * System.Threading.CancellationToken -> Microsoft.CodeAnalysis.Emit.EmitResult

Public Function Emit (peStream As Stream, Optional pdbStream As Stream = Nothing, Optional xmlDocumentationStream As Stream = Nothing, Optional win32Resources As Stream = Nothing, Optional manifestResources As IEnumerable(Of ResourceDescription) = Nothing, Optional options As EmitOptions = Nothing, Optional debugEntryPoint As IMethodSymbol = Nothing, Optional sourceLinkStream As Stream = Nothing, Optional embeddedTexts As IEnumerable(Of EmbeddedText) = Nothing, Optional metadataPEStream As Stream = Nothing, Optional cancellationToken As CancellationToken = Nothing) As EmitResult

Parameter

peStream

Stream

Stream, in den die Kompilierung geschrieben wird.

pdbStream

Stream

Streamen, in den die Debuginformationen der Kompilierung geschrieben werden. Null, um die PDB-Generation zu verzichten.

xmlDocumentationStream

Stream

Stream, in den die XML-Dokumentation der Kompilierung geschrieben wird. Null, um die XML-Generation zu verzichten.

win32Resources

Stream

Stream, aus dem die Win32-Ressourcen der Kompilierung gelesen werden (im RES-Format). Null, um anzugeben, dass keine vorhanden ist. Das RES-Format beginnt mit einem Null-Ressourceneintrag. Beachten Sie, dass der Anrufer für das Entsorgen dieses Datenstroms verantwortlich ist, sofern angegeben.

manifestResources

IEnumerable<ResourceDescription>

Liste der verwalteten Ressourcen der Kompilierung. Null, um anzugeben, dass keine vorhanden ist.

options

EmitOptions

Emitt-Optionen.

debugEntryPoint

IMethodSymbol

Debuggen des Einstiegspunkts der Assembly. Das Methodentoken wird im generierten PDB-Datenstrom gespeichert.

Wenn ein Programm mit einem Debugger gestartet wird, der den Debugger angefügt hat, platziert der erste Haltepunkt an den Anfang der Debug-Einstiegspunktmethode. Die CLR startet die Ausführung der statischen Main-Methode des Typs MainTypeName . Wenn der erste Haltepunkt auf die Debuggerschritte getroffen wird, führen Sie die Codeausweisung nach Anweisung durch, bis der Benutzercode erreicht ist, und überspringen Sie Methoden, die durch gekennzeichnet sind DebuggerHiddenAttribute, und berücksichtigen Sie andere Debuggingattribute.

Standardmäßig sind beide Einstiegspunkte in einem ausführbaren Programm (ConsoleApplication, WindowsApplication, WindowsRuntimeApplication) die gleiche Methode (Main). Ein nicht ausführbares Programm hat keinen Einstiegspunkt. Laufzeiten, die ein benutzerdefiniertes Ladeprogramm implementieren, können debugeinstiegspunkt angeben, um den Debugger zu erzwingen, um die Ausführung komplexer benutzerdefinierter Ladelogik am Anfang der .exe zu überspringen und so die Debugerfahrung zu verbessern.

Im Gegensatz zu einem normalen Einstiegspunkt, der auf eine nicht generische statische Methode bestimmter Signatur beschränkt ist, gibt es keine Einschränkungen für die debugEntryPoint Methode, die andere als einen Methodentext hat (extern, schnittstelle oder abstrakte Methoden sind nicht zulässig).

sourceLinkStream

Stream

Datenstrom, der Informationen enthält, die die Kompilierung mit einem Quellcodeverwaltung verknüpfen.

embeddedTexts

IEnumerable<EmbeddedText>

Texte, die in die PDB eingebettet werden sollen. Nur unterstützt, wenn portable PDBs aussendet werden.

metadataPEStream

Stream

Stream, in den die nur metadatengeschützte Ausgabe geschrieben wird.

cancellationToken

CancellationToken

Um den Emit-Prozess abzubrechen.

Gibt zurück

EmitResult