Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

AppDomain.GetData, méthode

Obtient la valeur stockée dans le domaine d'application actuel pour le nom spécifié.

Espace de noms :  System
Assembly :  mscorlib (dans mscorlib.dll)

public Object GetData(
	string name
)

Paramètres

name
Type : System.String
Nom d'une propriété de domaine d'application prédéfinie ou nom d'une propriété de domaine d'application que vous avez définie.

Valeur de retour

Type : System.Object
Valeur de la propriété name, ou null si elle n'existe pas.

Implémentations

_AppDomain.GetData(String)

ExceptionCondition
ArgumentNullException

name est null.

AppDomainUnloadedException

La tentative d'opération est en cours sur un domaine d'application non chargé.

Utilisez cette méthode pour récupérer la valeur d'une entrée dans un cache interne de paires nom/données qui décrivent les propriétés de cette instance de AppDomain.

Le cache contient automatiquement des entrées système prédéfinies qui sont insérées lors de la création du domaine d'application. Vous pouvez vérifier leurs valeurs à l'aide de la méthode GetData, ou des propriétés AppDomainSetup équivalentes.

Vous pouvez insérer ou modifier vos propres paires nom/données définies par l'utilisateur à l'aide de la méthode SetData et vérifier leurs valeurs à l'aide de la méthode GetData.

Le tableau suivant répertorie le name de chaque entrée système prédéfinie ainsi que la propriété AppDomainSetup correspondante.

Valeur de "name"

Propriété

"APPBASE"

ApplicationBase

"LOADER_OPTIMIZATION"

LoaderOptimization

"APP_CONFIG_FILE"

ConfigurationFile

"DYNAMIC_BASE"

DynamicBase

"DEV_PATH"

(aucune propriété)

"APP_NAME"

ApplicationName

"PRIVATE_BINPATH"

PrivateBinPath

"BINPATH_PROBE_ONLY"

PrivateBinPathProbe

"SHADOW_COPY_DIRS"

ShadowCopyDirectories

"FORCE_CACHE_INSTALL"

ShadowCopyFiles

"CACHE_BASE"

CachePath

(propre à l'application)

LicenseFile

"APP_LAUNCH_URL"

(aucune propriété)

RemarqueRemarque

"APP_LAUNCH_URL" représente l'URL initialement demandée par l'utilisateur, avant toute redirection. Elle est disponible uniquement lorsque l'application a été lancée avec un navigateur tel qu'Internet Explorer. Certains navigateurs ne fournissent pas cette valeur.

L'exemple de code suivant crée un nouveau domaine d'application, définit une valeur fournie par le système pour le domaine et ajoute une nouvelle paire de valeurs pour le domaine. L'exemple montre ensuite comment utiliser la méthode GetData pour récupérer les données de ces paires de valeur et les afficher à la console.


using System;
using System.Reflection;

class ADGetData 
{
    public static void Main() 
    {
        // appdomain setup information
        AppDomain currentDomain = AppDomain.CurrentDomain;

        //Create a new value pair for the appdomain
        currentDomain.SetData("ADVALUE", "Example value");

        //get the value specified in the setdata method
        Console.WriteLine("ADVALUE is: " + currentDomain.GetData("ADVALUE"));

        //get a system value specified at appdomainsetup
        Console.WriteLine("System value for loader optimization: {0}",
            currentDomain.GetData("LOADER_OPTIMIZATION"));
    }
}

/* This code example produces the following output:

ADVALUE is: Example value
System value for loader optimization: NotSpecified
 */



.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Date

Historique

Motif

Mars 2011

Le fait que null est retourné si name n'existe pas a été clarifié.

Commentaires client.

Afficher: