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

Referência

Definição

Namespace:: ReportService2010

Assembly:: ReportService2010.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona uma pasta ao banco de dados do servidor de relatório ou à biblioteca do SharePoint.

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

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateFolder", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public ReportService2010.CatalogItem CreateFolder (string Folder, string Parent, ReportService2010.Property[] Properties);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateFolder", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.CreateFolder : string * string * ReportService2010.Property[] -> ReportService2010.CatalogItem

Public Function CreateFolder (Folder As String, Parent As String, Properties As Property()) As CatalogItem

Parâmetros

Folder: String

O nome da nova pasta.

Parent: String

O nome de caminho completo da pasta pai na qual adicionar a nova pasta.

Properties: Property[]

Uma matriz de objetos Property que define os nomes e os valores de propriedades a serem definidos para a pasta.

Retornos

CatalogItem

A pasta criada.

Atributos: SoapDocumentMethodAttribute SoapHeaderAttribute

Exemplos

Para compilar esse exemplo de código, você deve referenciar o Reporting Services WSDL e importar determinados namespaces. Para obter mais informações, consulte Compilando e executando exemplos de código. O exemplo de código a seguir usa o CreateFolder método para criar uma pasta no banco de dados do servidor de relatório:

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2010()  
      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 ReportingService2010();  
      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);  
      }  
   }  
}

Comentários

A tabela a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.


Uso do cabeçalho SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Permissões necessárias do modo nativo	CreateFolder
Permissões necessárias do modo do SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.AddListItems>

O comprimento do nome do caminho completo da nova pasta não pode exceder 260 caracteres; caso contrário, uma exceção SOAP é gerada com o código rsItemLengthExceededde erro .

Os nomes de pasta devem ter menos de 128 caracteres. Os nomes não podem ser nulos, consistem em cadeias de caracteres vazias ou contêm os seguintes caracteres reservados: : ? ; @ & = + $ , \ * >< | . ". Você pode usar o caractere de barra (/) para separar itens no nome do caminho completo da pasta, mas não pode usá-lo no final do nome da pasta.

Se Meus Relatórios estiver habilitado, uma exceção SOAP será gerada com o código rsItemAlreadyExists de erro se você tentar criar uma pasta chamada "Meus Relatórios" na pasta raiz do banco de dados do servidor de relatório.

Adicionar uma pasta ao banco de dados do servidor de relatório modifica as ModifiedBy propriedades e ModifiedDate da pasta pai.

Aplica-se a

Share via