ReportingService2005.GetSubscriptionProperties Método
Definição
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.
Retorna as propriedades de uma assinatura especificada.
public:
System::String ^ GetSubscriptionProperties(System::String ^ SubscriptionID, [Runtime::InteropServices::Out] ReportService2005::ExtensionSettings ^ % ExtensionSettings, [Runtime::InteropServices::Out] System::String ^ % Description, [Runtime::InteropServices::Out] ReportService2005::ActiveState ^ % Active, [Runtime::InteropServices::Out] System::String ^ % Status, [Runtime::InteropServices::Out] System::String ^ % EventType, [Runtime::InteropServices::Out] System::String ^ % MatchData, [Runtime::InteropServices::Out] cli::array <ReportService2005::ParameterValue ^> ^ % Parameters);
public string GetSubscriptionProperties(string SubscriptionID, out ReportService2005.ExtensionSettings ExtensionSettings, out string Description, out ReportService2005.ActiveState Active, out string Status, out string EventType, out string MatchData, out ReportService2005.ParameterValue[] Parameters);
member this.GetSubscriptionProperties : string * ExtensionSettings * string * ActiveState * string * string * string * ParameterValue[] -> string
Public Function GetSubscriptionProperties (SubscriptionID As String, ByRef ExtensionSettings As ExtensionSettings, ByRef Description As String, ByRef Active As ActiveState, ByRef Status As String, ByRef EventType As String, ByRef MatchData As String, ByRef Parameters As ParameterValue()) As String
Parâmetros
- SubscriptionID
- String
A ID da assinatura.
- ExtensionSettings
- ExtensionSettings
[fora] Um ExtensionSettings objeto que contém uma lista de configurações específicas para a extensão de entrega.
- Description
- String
[fora] Uma descrição significativa que é exibida aos usuários.
- Active
- ActiveState
[fora] Um ActiveState objeto que contém o estado ativo da assinatura.
- Status
- String
[fora] O status da assinatura.
- EventType
- String
[fora] O tipo de evento que aciona a assinatura.
- MatchData
- String
[fora] Os dados associados ao tipo de evento especificado. Isso é usado por uma extensão de processamento de eventos para combinar a assinatura com um evento que foi disparado.
- Parameters
- ParameterValue[]
[fora] Um array de ParameterValue objetos que contém uma lista de parâmetros para o relatório.
Retornos
O ID de usuário do dono da assinatura.
Exemplos
Para compilar esse exemplo de código, você deve consultar o Reporting Services WSDL e importar certos namespaces. Para mais informações, veja Exemplos de Código Compilando e Executando. O exemplo de código a seguir usa o GetSubscriptionProperties método para recuperar as propriedades de uma das assinaturas do relatório do Catálogo de Produtos, que pertence ao usuário meuDomínio\meuNomeDeUsuário. A assinatura não é orientada por dados, então o código assume que todas as configurações da extensão de entrega são valores estáticos de parâmetros (ParameterValue objetos):
Imports System
Imports System.Web.Services.Protocols
Class Sample
Public Shared Sub Main()
Dim rs As New ReportingService2005()
rs.Credentials = System.Net.CredentialCache.DefaultCredentials
Dim extSettings As ExtensionSettings
Dim desc As String
Dim active As ActiveState
Dim status As String
Dim eventType As String
Dim matchData As String
Dim values As ParameterValue() = Nothing
Dim subscriptions As Subscription() = Nothing
Dim extensionParams As ParameterValueOrFieldReference() = Nothing
Try
subscriptions = rs.ListSubscriptions("/SampleReports/Employee Sales Summary", "Domain\username")
If Not (subscriptions Is Nothing) Then
rs.GetSubscriptionProperties(subscriptions(0).SubscriptionID, extSettings, desc, active, status, eventType, matchData, values)
Console.WriteLine("Description: {0}", desc)
Console.WriteLine("Status: {0}", status)
Console.WriteLine("EventType: {0}", eventType)
Console.WriteLine("matchData: {0}", matchData)
Console.WriteLine("Extension: {0}", extSettings.Extension)
extensionParams = extSettings.ParameterValues
If Not (extensionParams Is Nothing) Then
Dim extensionParam As ParameterValueOrFieldReference
For Each extensionParam In extensionParams
Console.WriteLine((CType(extensionParam, ParameterValue).Name + ": " + CType(extensionParam, ParameterValue).Value))
Next extensionParam
End If
If Not (values Is Nothing) Then
Dim pv As ParameterValue
For Each pv In values
Console.WriteLine("Name: {0}", pv.Name)
Console.WriteLine("Value: {0}", pv.Value)
Next pv
End If
End If
Catch e As SoapException
Console.WriteLine(e.Detail.InnerXml.ToString())
End Try
End Sub 'Main
End Class 'Sample
using System;
using System.Web.Services.Protocols;
class Sample
{
public static void Main()
{
ReportingService2005 rs = new ReportingService2005();
rs.Credentials = System.Net.CredentialCache.DefaultCredentials;
ExtensionSettings extSettings;
string desc;
ActiveState active;
string status;
string eventType;
string matchData;
ParameterValue[] values = null;
Subscription[] subscriptions = null;
ParameterValueOrFieldReference[] extensionParams = null;
try
{
subscriptions = rs.ListSubscriptions( "/SampleReports/Employee Sales Summary", "Domain\\username" );
if ( subscriptions != null )
{
rs.GetSubscriptionProperties( subscriptions[0].SubscriptionID, name, out extSettings, out desc, out active, out status, out eventType, out matchData, out values );
Console.WriteLine( "Description: {0}", desc );
Console.WriteLine( "Status: {0}", status );
Console.WriteLine( "EventType: {0}", eventType );
Console.WriteLine( "matchData: {0}", matchData );
Console.WriteLine( "Extension: {0}", extSettings.Extension );
extensionParams = extSettings.ParameterValues;
if (extensionParams != null)
{
foreach (ParameterValueOrFieldReference extensionParam in extensionParams)
{
Console.WriteLine( ((ParameterValue)extensionParam).Name + ": " + ((ParameterValue)extensionParam).Value );
}
}
if ( values != null )
{
foreach ( ParameterValue pv in values )
{
Console.WriteLine( "Name: {0}", pv.Name );
Console.WriteLine( "Value: {0}", pv.Value );
}
}
}
}
catch ( SoapException e )
{
Console.WriteLine( e.Detail.InnerXml.ToString() );
}
}
}
Comentários
A tabela abaixo mostra informações sobre cabeçalhos e permissões sobre esta operação.
| Cabeçalhos SOAP | (Fora) ServerInfoHeaderValue |
| Permissões necessárias | (ReadSubscription no relatório E o usuário é o dono da assinatura) OU ReadAnySubscription |