ReportingService2010.GetExtensionSettings(String) Método

Definição

Namespace:

ReportService2010

Assembly:

ReportService2010.dll

Retorna uma lista de configurações para uma determinada extensão.

public:
 cli::array <ReportService2010::ExtensionParameter ^> ^ GetExtensionSettings(System::String ^ Extension);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetExtensionSettings", 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.ExtensionParameter[] GetExtensionSettings (string Extension);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetExtensionSettings", 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.GetExtensionSettings : string -> ReportService2010.ExtensionParameter[]

Public Function GetExtensionSettings (Extension As String) As ExtensionParameter()

Parâmetros

Extension

String

O nome da extensão conforme ele aparece no arquivo de configurações do servidor de relatório. Os valores válidos são Report Server Email, Report Server DocumentLibrarye Report Server FileShare.

Retornos

ExtensionParameter[]

Uma matriz de ExtensionParameter objetos que representam a lista de configurações conhecidas para uma determinada extensão.

Atributos

SoapDocumentMethodAttribute SoapHeaderAttribute

Exemplos

using System;  
using System.Collections.Generic;  
using System.IO;  
using System.Text;  
using System.Web;  
using System.Web.Services;  
using System.Web.Services.Protocols;  

class Sample  
{  
    static void Main(string[] args)  
    {  
        ReportingService2010 rs = new ReportingService2010();  
        rs.Url = "http://<Server Name>" +   
            "/_vti_bin/ReportServer/ReportService2010.asmx";  
        rs.Credentials =   
            System.Net.CredentialCache.DefaultCredentials;  

        ExtensionParameter[] extensionParams = null;  

        try  
        {  
            extensionParams =   
                rs.GetExtensionSettings(  
                    "Report Server DocumentLibrary");  

            Console.WriteLine("Settings retrieved.");  

            if (extensionParams != null)  
            {  
                foreach (ExtensionParameter extensionParam   
                    in extensionParams)  
                {  
                    Console.WriteLine("Value: {0}",   
                        extensionParam.Value);  
                    Console.WriteLine("Name: {0}",   
                        extensionParam.Name);  
                    Console.WriteLine("ReadOnly: {0}",   
                       extensionParam.ReadOnly);  
                    Console.WriteLine("Required: {0}",   
                        extensionParam.Required);  
                }  
            }  
        }  

        catch (SoapException e)  
        {  
            Console.WriteLine(e.Detail.InnerXml.ToString());  
        }  
    }  
}  

Imports System  
Imports System.IO  
Imports System.Text  
Imports System.Web.Services  
Imports System.Web.Services.Protocols  

Class Sample  

    Public Shared Sub Main()  

        Dim rs As New ReportingService2010()  
        rs.Url = "http://<Server Name>" + _  
            "/_vti_bin/ReportServer/ReportService2010.asmx"  
        rs.Credentials = _  
            System.Net.CredentialCache.DefaultCredentials  

        Dim extensionParams As ExtensionParameter() = Nothing  

        Try  
            extensionParams = _  
                rs.GetExtensionSettings("Report Server " + _  
                    "DocumentLibrary")  

            Console.WriteLine("Settings retrieved.")  

            If Not (extensionParams Is Nothing) Then  
                Dim extensionParam As ExtensionParameter  
                For Each extensionParam In extensionParams  
                    Console.WriteLine("Value: {0}", _  
                        extensionParam.Value)  
                    Console.WriteLine("Name: {0}", _  
                        extensionParam.Name)  
                    Console.WriteLine("ReadOnly: {0}", _  
                        extensionParam.ReadOnly)  
                    Console.WriteLine("Required: {0}", _  
                        extensionParam.Required)  
                Next extensionParam  
            End If  

        Catch e As SoapException  
            Console.WriteLine(e.Detail.InnerXml.ToString())  
        End Try  

    End Sub  

End Class  

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	Nenhum
Permissões necessárias do modo do SharePoint	Nenhum

Se a extensão não der suporte a parâmetros de extensão, uma lista vazia será retornada.

Observação

Atualmente, o método dá suporte a GetExtensionSettings extensões de entrega. Outras extensões ainda não são compatíveis com esse método.