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

Riferimento

Definizione

Spazio dei nomi:: ReportService2005

Assembly:: ReportService2005.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Aggiunge una cartella al database del server di report.

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

Parametri

Folder: String

Nome della nuova cartella.

Parent: String

Nome e percorso completo della cartella padre nella quale aggiungere la nuova cartella.

Properties: Property[]

Matrice di oggetti Property che definisce i nomi e i valori delle proprietà da impostare per la cartella.

Esempio

Per compilare questo esempio di codice, è necessario fare riferimento alla Reporting Services WSDL e importare determinati spazi dei nomi. Per altre informazioni, vedere Compilazione ed esecuzione di esempi di codice. Nell'esempio di codice seguente viene usato il CreateFolder metodo per creare una cartella nel database del server di report:

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

Commenti

Nella tabella seguente vengono mostrate le informazioni sull'intestazione e sulle autorizzazioni relative a questa operazione.


Intestazioni SOAP	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Autorizzazioni necessarie	CreateFolder

La lunghezza del nome completo del percorso per la nuova cartella non può superare i 260 caratteri; in caso contrario, viene generata un'eccezione SOAP con il codice rsItemPathLengthExceededdi errore .

I nomi delle cartelle devono essere inferiori a 128 caratteri. I nomi non possono essere Null, sono costituiti da stringhe vuote o contengono i caratteri riservati seguenti: : ? ; @ & = + $ , \ * >< | . ". È possibile usare il carattere barra in avanti (/) per separare gli elementi nel nome completo del percorso della cartella, ma non è possibile usarlo alla fine del nome della cartella.

Se i report personali sono abilitati, viene generata un'eccezione SOAP con il codice rsItemAlreadyExists di errore se si tenta di creare una cartella denominata "Report personali" nella cartella radice del database del server di report.

L'aggiunta di una cartella al database del server di report modifica le ModifiedBy proprietà e ModifiedDate della cartella padre.

Si applica a

Condividi tramite