ReportingService2005.CreateFolder(String, String, Property[]) Methode

Definition

Fügt der Berichtsserver-Datenbank einen Ordner hinzu.

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())

Parameter

Folder
String

Der Name des neuen Ordners.

Parent
String

Der vollständige Pfadname des übergeordneten Ordners, dem der neue Ordner hinzugefügt werden soll.

Properties
Property[]

Ein Array von Property-Objekten, das die Eigenschaftennamen und die Werte definiert, die für den Ordner festgelegt werden sollen.

Beispiele

Um dieses Codebeispiel zu kompilieren, müssen Sie auf die Reporting Services WSDL verweisen und bestimmte Namespaces importieren. Weitere Informationen finden Sie unter Kompilieren und Ausführen von Codebeispielen. Im folgenden Codebeispiel wird die CreateFolder -Methode verwendet, um einen Ordner in der Berichtsserver-Datenbank zu erstellen:

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);  
      }  
   }  
}  

Hinweise

In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.

SOAP-Header (In) BatchHeaderValue

(Out) ServerInfoHeaderValue
Erforderliche Berechtigungen CreateFolder

Die Länge des vollständigen Pfadnamens für den neuen Ordner darf 260 Zeichen nicht überschreiten. Andernfalls wird eine SOAP-Ausnahme mit dem Fehlercode rsItemPathLengthExceededausgelöst.

Ordnernamen müssen weniger als 128 Zeichen lang sein. Die Namen dürfen nicht NULL sein, aus leeren Zeichenfolgen bestehen oder die folgenden reservierten Zeichen enthalten: : ? ; @ & = + $ , \ * >< | . ". Sie können den Schrägstrich (/) verwenden, um Elemente im vollständigen Pfadnamen des Ordners zu trennen, aber Sie können ihn nicht am Ende des Ordnernamens verwenden.

Wenn Meine Berichte aktiviert ist, wird eine SOAP-Ausnahme mit dem Fehlercode rsItemAlreadyExists ausgelöst, wenn Sie versuchen, einen Ordner namens "Meine Berichte" im Stammordner der Berichtsserver-Datenbank zu erstellen.

Durch das Hinzufügen eines Ordners zur Berichtsserver-Datenbank werden die ModifiedBy Eigenschaften und ModifiedDate des übergeordneten Ordners geändert.

Gilt für: