ReportingService2005.CreateFolder(String, String, Property[]) Méthode

Définition

Espace de noms:

ReportService2005

Assembly:

ReportService2005.dll

Ajoute un dossier à la base de données du serveur de rapports.

public:
 void CreateFolder(System::String ^ Folder, System::String ^ Parent, cli::array <ReportService2005::Property ^> ^ Properties);

public void CreateFolder (string Folder, string Parent, ReportService2005.Property[] Properties);

member this.CreateFolder : string * string * ReportService2005.Property[] -> unit

Public Sub CreateFolder (Folder As String, Parent As String, Properties As Property())

Paramètres

Folder

String

Nom du nouveau dossier.

Parent

String

Nom du chemin d'accès complet du dossier parent auquel ajouter le nouveau dossier.

Properties

Property[]

Tableau d'objets Property qui définit les noms et valeurs des propriétés à définir pour le dossier.

Exemples

Pour compiler cet exemple de code, vous devez référencer le Reporting Services WSDL et importer certains espaces de noms. Pour plus d’informations, consultez Compilation et exécution d’exemples de code. L’exemple de code suivant utilise la CreateFolder méthode pour créer un dossier dans la base de données du serveur de rapports :

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      ' Create a custom property for the folder.  
      Dim newProp As New [Property]()  
      newProp.Name = "Department"  
      newProp.Value = "Finance"  
      Dim props(0) As [Property]  
      props(0) = newProp  

      Dim folderName As String = "Budget"  

      Try  
         rs.CreateFolder(folderName, "/", props)  
         Console.WriteLine("Folder created: {0}", folderName)  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml)  
      End Try  
   End Sub 'Main  
End Class 'Sample  

using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      // Create a custom property for the folder.  
      Property newProp = new Property();  
      newProp.Name = "Department";  
      newProp.Value = "Finance";  
      Property[] props = new Property[1];  
      props[0] = newProp;  

      string folderName = "Budget";  

      try  
      {  
         rs.CreateFolder(folderName, "/", props);  
         Console.WriteLine("Folder created: {0}", folderName);  
      }  

      catch(SoapException e)  
      {  
         Console.WriteLine(e.Detail.InnerXml);  
      }  
   }  
}  

Remarques

Le tableau suivant présente les informations relatives aux en-têtes et aux autorisations sur cette opération.

En-têtes SOAP	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Autorisations requises	CreateFolder

La longueur du nom de chemin d’accès complet du nouveau dossier ne peut pas dépasser 260 caractères ; sinon, une exception SOAP est levée avec le code rsItemPathLengthExceededd’erreur .

Les noms de dossiers doivent contenir moins de 128 caractères. Les noms ne peuvent pas être null, se composer de chaînes vides ou contenir les caractères réservés suivants : ? ; @ & = + $ , \ * >< | . ". Vous pouvez utiliser la barre oblique (/) pour séparer les éléments dans le nom complet du chemin d’accès du dossier, mais vous ne pouvez pas l’utiliser à la fin du nom du dossier.

Si Mes rapports est activé, une exception SOAP est levée avec le code rsItemAlreadyExists d’erreur si vous tentez de créer un dossier nommé « Mes rapports » dans le dossier racine de la base de données du serveur de rapports.

L’ajout d’un dossier à la base de données du serveur de rapports modifie les ModifiedBy propriétés et ModifiedDate du dossier parent.