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

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

Parámetros

Ejemplos

Para compilar este ejemplo de código, debes consultar el WSDL de Reporting Services e importar ciertos espacios de nombres. Para más información, consulte Ejemplos de Compilación y Ejecución de Código. El siguiente ejemplo de código utiliza este CreateFolder método para crear una carpeta en la base de datos del servidor de informes:

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

Comentarios

La siguiente tabla muestra la información sobre cabeceras y permisos sobre esta operación.

La longitud del nombre completo del camino para la nueva carpeta no puede superar los 260 caracteres; de lo contrario, se lanza una excepción SOAP con el código rsItemPathLengthExceededde error .

Los nombres de las carpetas deben tener menos de 128 caracteres. Los nombres no pueden ser nulos, consistir en cadenas vacías ni contener los siguientes caracteres reservados: : ? ; @ & = + $ , \ * >< | . ". Puedes usar el carácter de barra hacia adelante (/) para separar elementos en el nombre completo de la carpeta, pero no puedes usarlo al final del nombre de la carpeta.

Si My Reports está habilitado, se lanza una excepción SOAP con el código rsItemAlreadyExists de error si intentas crear una carpeta llamada "My Reports" en la carpeta raíz de la base de datos del servidor de informes.

Añadir una carpeta a la base de datos del servidor de informes modifica las ModifiedBy propiedades y ModifiedDate de la carpeta padre.