EmitBaseline.CreateInitialBaseline Méthode

Définition

Espace de noms:

Microsoft.CodeAnalysis.Emit

Assembly:

Microsoft.CodeAnalysis.dll

Paquet:

Microsoft.CodeAnalysis.Common v4.9.2

Surcharges

CreateInitialBaseline(ModuleMetadata, Func<MethodDefinitionHandle,EditAndContinueMethodDebugInformation>)	Obsolète. Crée un EmitBaseline à partir des métadonnées du module avant la modification et d’une fonction qui mappe d’une méthode à un tableau de noms locaux.
CreateInitialBaseline(ModuleMetadata, Func<MethodDefinitionHandle, EditAndContinueMethodDebugInformation>, Func<MethodDefinitionHandle, StandaloneSignatureHandle>, Boolean)	Obsolète. Crée un EmitBaseline à partir des métadonnées du module avant la modification et d’une fonction qui mappe d’une méthode à un tableau de noms locaux.
CreateInitialBaseline(Compilation, ModuleMetadata, Func<MethodDefinitionHandle, EditAndContinueMethodDebugInformation>, Func<MethodDefinitionHandle, StandaloneSignatureHandle>, Boolean)	Crée un EmitBaseline à partir des métadonnées du module avant la modification et d’une fonction qui mappe d’une méthode à un tableau de noms locaux.

CreateInitialBaseline(ModuleMetadata, Func<MethodDefinitionHandle,EditAndContinueMethodDebugInformation>)

Source:

EmitBaseline.cs

Attention

This overload is no longer supported

Crée un EmitBaseline à partir des métadonnées du module avant la modification et d’une fonction qui mappe d’une méthode à un tableau de noms locaux.

public:
 static Microsoft::CodeAnalysis::Emit::EmitBaseline ^ CreateInitialBaseline(Microsoft::CodeAnalysis::ModuleMetadata ^ module, Func<System::Reflection::Metadata::MethodDefinitionHandle, Microsoft::CodeAnalysis::Emit::EditAndContinueMethodDebugInformation> ^ debugInformationProvider);

[System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
[System.Obsolete("This overload is no longer supported", true)]
public static Microsoft.CodeAnalysis.Emit.EmitBaseline CreateInitialBaseline (Microsoft.CodeAnalysis.ModuleMetadata module, Func<System.Reflection.Metadata.MethodDefinitionHandle,Microsoft.CodeAnalysis.Emit.EditAndContinueMethodDebugInformation> debugInformationProvider);

[<System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)>]
[<System.Obsolete("This overload is no longer supported", true)>]
static member CreateInitialBaseline : Microsoft.CodeAnalysis.ModuleMetadata * Func<System.Reflection.Metadata.MethodDefinitionHandle, Microsoft.CodeAnalysis.Emit.EditAndContinueMethodDebugInformation> -> Microsoft.CodeAnalysis.Emit.EmitBaseline

Public Shared Function CreateInitialBaseline (module As ModuleMetadata, debugInformationProvider As Func(Of MethodDefinitionHandle, EditAndContinueMethodDebugInformation)) As EmitBaseline

Paramètres

module

ModuleMetadata

Métadonnées du module avant modification.

debugInformationProvider

Func<MethodDefinitionHandle,EditAndContinueMethodDebugInformation>

Fonction qui, pour un handle de méthode, retourne les informations de débogage Edit et Continue émises par le compilateur dans le PDB. La fonction doit lever InvalidDataException si les informations de débogage ne peuvent pas être lues pour la méthode spécifiée. Cette exception et IOException sont interceptés et convertis en diagnostic d’émission. D’autres exceptions sont transmises.

Retours

EmitBaseline

pour EmitBaseline le module.

Attributs

EditorBrowsableAttribute ObsoleteAttribute

Exceptions

ArgumentException

module n’est pas une image PE.

ArgumentNullException

debugInformationProvider a la valeur null.

IOException

Erreur de lecture des métadonnées de module.

BadImageFormatException

Les métadonnées de module ne sont pas valides.

ObjectDisposedException

Le module a été supprimé.

CreateInitialBaseline(ModuleMetadata, Func<MethodDefinitionHandle, EditAndContinueMethodDebugInformation>, Func<MethodDefinitionHandle, StandaloneSignatureHandle>, Boolean)

Source:

EmitBaseline.cs

Attention

This overload is no longer supported

Crée un EmitBaseline à partir des métadonnées du module avant la modification et d’une fonction qui mappe d’une méthode à un tableau de noms locaux.

public:
 static Microsoft::CodeAnalysis::Emit::EmitBaseline ^ CreateInitialBaseline(Microsoft::CodeAnalysis::ModuleMetadata ^ module, Func<System::Reflection::Metadata::MethodDefinitionHandle, Microsoft::CodeAnalysis::Emit::EditAndContinueMethodDebugInformation> ^ debugInformationProvider, Func<System::Reflection::Metadata::MethodDefinitionHandle, System::Reflection::Metadata::StandaloneSignatureHandle> ^ localSignatureProvider, bool hasPortableDebugInformation);

[System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
[System.Obsolete("This overload is no longer supported", true)]
public static Microsoft.CodeAnalysis.Emit.EmitBaseline CreateInitialBaseline (Microsoft.CodeAnalysis.ModuleMetadata module, Func<System.Reflection.Metadata.MethodDefinitionHandle,Microsoft.CodeAnalysis.Emit.EditAndContinueMethodDebugInformation> debugInformationProvider, Func<System.Reflection.Metadata.MethodDefinitionHandle,System.Reflection.Metadata.StandaloneSignatureHandle> localSignatureProvider, bool hasPortableDebugInformation);

[<System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)>]
[<System.Obsolete("This overload is no longer supported", true)>]
static member CreateInitialBaseline : Microsoft.CodeAnalysis.ModuleMetadata * Func<System.Reflection.Metadata.MethodDefinitionHandle, Microsoft.CodeAnalysis.Emit.EditAndContinueMethodDebugInformation> * Func<System.Reflection.Metadata.MethodDefinitionHandle, System.Reflection.Metadata.StandaloneSignatureHandle> * bool -> Microsoft.CodeAnalysis.Emit.EmitBaseline

Public Shared Function CreateInitialBaseline (module As ModuleMetadata, debugInformationProvider As Func(Of MethodDefinitionHandle, EditAndContinueMethodDebugInformation), localSignatureProvider As Func(Of MethodDefinitionHandle, StandaloneSignatureHandle), hasPortableDebugInformation As Boolean) As EmitBaseline

Paramètres

module

ModuleMetadata

Métadonnées du module avant modification.

debugInformationProvider

Func<MethodDefinitionHandle,EditAndContinueMethodDebugInformation>

Fonction qui, pour un handle de méthode, retourne les informations de débogage Edit et Continue émises par le compilateur dans le PDB. La fonction doit lever InvalidDataException si les informations de débogage ne peuvent pas être lues pour la méthode spécifiée. Cette exception et IOException sont interceptés et convertis en diagnostic d’émission. D’autres exceptions sont transmises.

localSignatureProvider

Func<MethodDefinitionHandle,StandaloneSignatureHandle>

Fonction qui, pour un handle de méthode, retourne la signature de ses variables locales. La fonction doit être levée InvalidDataException si les informations ne peuvent pas être lues pour la méthode spécifiée. Cette exception et IOException sont interceptés et convertis en diagnostic d’émission. D’autres exceptions sont transmises.

hasPortableDebugInformation

Boolean

True si la base de données PDB de base de référence est portable.

Retours

EmitBaseline

pour EmitBaseline le module.

Attributs

EditorBrowsableAttribute ObsoleteAttribute

Exceptions

ArgumentNullException

localSignatureProvider a la valeur null.

IOException

Erreur de lecture des métadonnées de module.

BadImageFormatException

Les métadonnées de module ne sont pas valides.

ObjectDisposedException

Le module a été supprimé.

Remarques

Seule la base de référence initiale est créée à l’aide de cette méthode ; les bases de référence suivantes sont créées automatiquement lors de l’émission des différences dans les compilations suivantes.

Lorsqu’une méthode active (pour laquelle une trame est allouée sur une pile) est mise à jour, les valeurs de ses variables locales doivent être conservées. Le mappage des noms de variables locales à leurs emplacements dans l’image n’est pas inclus dans les métadonnées et doit donc être fourni par debugInformationProvider.

le debugInformationProvider est uniquement nécessaire pour la génération initiale. Le mappage pour les générations suivantes est transféré via EmitBaseline. Le compilateur affecte des emplacements aux variables locales nommées (y compris les variables temporaires nommées) dans l’ordre dans lequel ils apparaissent dans le code source. Cette propriété permet au compilateur de reconstruire le mappage de variables locales pour la génération initiale. Une génération suivante peut ajouter une nouvelle variable entre deux variables de la génération précédente. Étant donné que les emplacements des variables de génération précédente doivent être conservés, la seule option consiste à ajouter ces nouvelles variables à la fin. L’ordre des emplacements ne correspond donc plus à l’ordre de syntaxe. Il est donc nécessaire de passer Baseline à la génération suivante (plutôt que de créer EmitBaselinedes s à partir de zéro en fonction des métadonnées produites par les compilations suivantes).

CreateInitialBaseline(Compilation, ModuleMetadata, Func<MethodDefinitionHandle, EditAndContinueMethodDebugInformation>, Func<MethodDefinitionHandle, StandaloneSignatureHandle>, Boolean)

Source:

EmitBaseline.cs

Crée un EmitBaseline à partir des métadonnées du module avant la modification et d’une fonction qui mappe d’une méthode à un tableau de noms locaux.

public static Microsoft.CodeAnalysis.Emit.EmitBaseline CreateInitialBaseline (Microsoft.CodeAnalysis.Compilation compilation, Microsoft.CodeAnalysis.ModuleMetadata module, Func<System.Reflection.Metadata.MethodDefinitionHandle,Microsoft.CodeAnalysis.Emit.EditAndContinueMethodDebugInformation> debugInformationProvider, Func<System.Reflection.Metadata.MethodDefinitionHandle,System.Reflection.Metadata.StandaloneSignatureHandle> localSignatureProvider, bool hasPortableDebugInformation);

static member CreateInitialBaseline : Microsoft.CodeAnalysis.Compilation * Microsoft.CodeAnalysis.ModuleMetadata * Func<System.Reflection.Metadata.MethodDefinitionHandle, Microsoft.CodeAnalysis.Emit.EditAndContinueMethodDebugInformation> * Func<System.Reflection.Metadata.MethodDefinitionHandle, System.Reflection.Metadata.StandaloneSignatureHandle> * bool -> Microsoft.CodeAnalysis.Emit.EmitBaseline

Public Shared Function CreateInitialBaseline (compilation As Compilation, module As ModuleMetadata, debugInformationProvider As Func(Of MethodDefinitionHandle, EditAndContinueMethodDebugInformation), localSignatureProvider As Func(Of MethodDefinitionHandle, StandaloneSignatureHandle), hasPortableDebugInformation As Boolean) As EmitBaseline

Paramètres

compilation

Compilation

Initial Microsoft.CodeAnalysis.Emit.EmitBaseline.Compilation.

module

ModuleMetadata

Métadonnées du module avant modification.

debugInformationProvider

Func<MethodDefinitionHandle,EditAndContinueMethodDebugInformation>

Fonction qui, pour un handle de méthode, retourne les informations de débogage Edit et Continue émises par le compilateur dans le PDB. La fonction doit lever InvalidDataException si les informations de débogage ne peuvent pas être lues pour la méthode spécifiée. Cette exception et IOException sont interceptés et convertis en diagnostic d’émission. D’autres exceptions sont transmises.

localSignatureProvider

Func<MethodDefinitionHandle,StandaloneSignatureHandle>

Fonction qui, pour un handle de méthode, retourne la signature de ses variables locales. La fonction doit être levée InvalidDataException si les informations ne peuvent pas être lues pour la méthode spécifiée. Cette exception et IOException sont interceptés et convertis en diagnostic d’émission. D’autres exceptions sont transmises.

hasPortableDebugInformation

Boolean

True si la base de données PDB de base de référence est portable.

Retours

EmitBaseline

pour EmitBaseline le module.

Exceptions

ArgumentNullException

localSignatureProvider a la valeur null.

IOException

Erreur de lecture des métadonnées de module.

BadImageFormatException

Les métadonnées de module ne sont pas valides.

ObjectDisposedException

Le module a été supprimé.

Remarques

Seule la base de référence initiale est créée à l’aide de cette méthode ; les bases de référence suivantes sont créées automatiquement lors de l’émission des différences dans les compilations suivantes.

Lorsqu’une méthode active (pour laquelle une trame est allouée sur une pile) est mise à jour, les valeurs de ses variables locales doivent être conservées. Le mappage des noms de variables locales à leurs emplacements dans l’image n’est pas inclus dans les métadonnées et doit donc être fourni par debugInformationProvider.

le debugInformationProvider est uniquement nécessaire pour la génération initiale. Le mappage pour les générations suivantes est transféré via EmitBaseline. Le compilateur affecte des emplacements aux variables locales nommées (y compris les variables temporaires nommées) dans l’ordre dans lequel ils apparaissent dans le code source. Cette propriété permet au compilateur de reconstruire le mappage de variables locales pour la génération initiale. Une génération suivante peut ajouter une nouvelle variable entre deux variables de la génération précédente. Étant donné que les emplacements des variables de génération précédente doivent être conservés, la seule option consiste à ajouter ces nouvelles variables à la fin. L’ordre des emplacements ne correspond donc plus à l’ordre de syntaxe. Il est donc nécessaire de passer Baseline à la génération suivante (plutôt que de créer EmitBaselinedes s à partir de zéro en fonction des métadonnées produites par les compilations suivantes).