Dossiers d'applications

Les fichiers des applications personnalisées peuvent être stockés dans un dossier d'application, sur le serveur domestique. Si le serveur contient des dossiers d'applications, vous pouvez obtenir des informations sur ces dossiers par le biais de l'API de Windows Home Server, en vue de les utiliser dans votre application personnalisée.

Propriétés des dossiers d'application

Un dossier d'application individuel est représenté en tant qu'objet IApplicationFolder et dispose de propriétés en lecture seule pour les attributs suivants :

  • Nom
  • État de la duplication des dossiers
  • Chemin

Exemple

Étape 1. Créez une instance de WHSInfoClass.

Comme pour la plupart des objets de l'API de Windows Home Server, avant d'extraire des informations concernant les dossiers d'application vous devez créer une instance de WHSInfoClass, comme suit :

                
WHSInfoClass pInfo = new WHSInfoClass();

Étape 2 (scénario 1). Invoquez la méthode GetApplicationFolder(System.Guid).

Pour obtenir une référence à un dossier d'application existant, utilisez la méthode GetApplicationFolder de WHSInfoClass. La méthode GetApplicationFolder n'accepte qu'une structure System.Guid comme unique paramètre, et elle renvoie un objet IApplicationFolder qui représente un dossier d'application existant :

                
Guid myID = new Guid("61320935-2B2F-4b10-84DC-2DFA819F0A97");
IApplicationFolder pFolder = pInfo.GetApplicationFolder(myID);

Étape 2 (scénario 2). Invoquez la méthode CreateApplicationFolder(System.Guid, string).

Pour créer une référence pour un nouveau dossier d'application, utilisez la méthode CreateApplicationFolder de WHSInfoClass. La méthode CreateApplicationFolder accepte une structure System.Guid et une chaîne comme paramètres d'entrée, et elle renvoie un objet IApplicationFolder qui représente un nouveau dossier d'application :

                
Guid myID = Guid.NewGuid();
// The string is a friendly name for the folder
string name = "My application folder";
IApplicationFolder pFolder = pInfo.GetApplicationFolder(myID, name);
Remarque
Vous pouvez créer un GUID à l'aide de la méthode de votre choix. Toutefois, le paramètre des méthodes CreateApplicationFolder et GetApplicationFolder doit être de type System.Guid.

Dans l'exemple CreateApplicationFolder ci-dessus, le GUID a été créé à l'aide de la méthode System.Guid NewGuid() static. Cette méthode crée un nouveau System.Guid avec un nouveau GUID.

Étape 2 (scénario 3). Invoquez GetApplicationFolders().

Pour extraire tous les dossiers d'application du serveur domestique, utilisez la méthode GetApplicationFolders. La méthode GetApplicationFolders n'accepte aucun paramètre et renvoie un tableau d'objets IApplicationFolder.

                
Array folders = pInfo.GetApplicationFolders();

Étape 3. Parcourez le tableau dans une boucle.

La méthode GetApplicationFolders renvoie un tableau d'objets IApplicationFolder qu'il vous est possible de parcourir dans une boucle afin d'obtenir des informations sur un dossier d'application précis :

                
foreach (IApplicationFolder pFolder in folders) 
{
  Console.WriteLine("Name: {0}" + pFolder.Name);
  Console.WriteLine("Path: {0}" + pFolder.Path);
}

Vous pouvez recourir à cette approche chaque fois que vous manipulez des dossiers d'application via l'API de Windows Home Server.

Voir aussi

Page view tracker