ReportingService2005.CreateFolder(String, String, Property[]) Metodo
Definizione
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
Il nome della nuova cartella.
- Parent
- String
Il nome completo del percorso della cartella genitore a cui aggiungere la nuova cartella.
- Properties
- Property[]
Un array di Property oggetti che definisce i nomi delle proprietà e i valori da impostare per la cartella.
Esempio
Per compilare questo esempio di codice, devi fare riferimento al WSDL di Reporting Services e importare determinati namespace. Per maggiori informazioni, vedi Compiling and Conducting Code Examples. Il seguente esempio di codice utilizza il CreateFolder metodo per creare una cartella nel database del server di rapporti:
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
La tabella sottostante mostra informazioni sull'intestazione e sui permessi di questa operazione.
| Intestazioni SOAP | (Dentro) BatchHeaderValue (Fuori) ServerInfoHeaderValue |
| Autorizzazioni necessarie | CreateFolder |
La lunghezza del nome completo del percorso per la nuova cartella non può superare i 260 caratteri; altrimenti, viene lanciata un'eccezione SOAP con il codice rsItemPathLengthExceededdi errore .
I nomi delle cartelle devono essere meno di 128 caratteri. I nomi non possono essere nulli, consistere in stringhe vuote o contenere i seguenti caratteri riservati: ? ; @ & = + $ , \ * >< | . ". Puoi usare il carattere a barra avanzata (/) per separare gli elementi nel nome completo del percorso della cartella, ma non puoi usarlo alla fine del nome della cartella.
Se My Reports è abilitato, viene lanciata un'eccezione SOAP con il codice rsItemAlreadyExists di errore se si tenta di creare una cartella chiamata "My Reports" nella cartella radice del database del server di report.
Aggiungere una cartella al database del server report modifica le ModifiedBy proprietà e ModifiedDate della cartella genitore.