ReportingService2005.SetSystemProperties(Property[]) 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.
Define uma ou mais propriedades do sistema.
public:
void SetSystemProperties(cli::array <ReportService2005::Property ^> ^ Properties);
public void SetSystemProperties (ReportService2005.Property[] Properties);
member this.SetSystemProperties : ReportService2005.Property[] -> unit
Public Sub SetSystemProperties (Properties As Property())
Parâmetros
- Properties
- Property[]
Uma matriz de objetos Property que define as propriedades e os valores do sistema a serem definidos para um servidor de relatório.
Exemplos
A tabela a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.
Cabeçalhos SOAP | (Out) ServerInfoHeaderValue |
Permissões necessárias | UpdateSystemProperties (Sistema) |
Para compilar o exemplo de código a seguir, você deve referenciar o WSDL Reporting Services e importar determinados namespaces. Para obter mais informações, consulte Compilando e executando exemplos de código. O exemplo de código a seguir cria uma nova propriedade do sistema chamada Descrição 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 ReportingService2005()
rs.Credentials = System.Net.CredentialCache.DefaultCredentials
Dim setProp As New [Property]()
setProp.Name = "Description"
setProp.Value = "My report server that resides on the computer named RSSERVER1."
Dim props(0) As [Property]
props(0) = setProp
Try
rs.SetSystemProperties(props)
Console.WriteLine("New site property set.")
Catch ex As SoapException
Console.WriteLine(ex.Detail.OuterXml)
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;
Property setProp = new Property();
setProp.Name = "Description";
setProp.Value = "My report server that resides on the computer named RSSERVER1.";
Property[] props = new Property[1];
props[0] = setProp;
try
{
rs.SetSystemProperties( props );
Console.WriteLine( "New site property set." );
}
catch (SoapException ex)
{
Console.WriteLine( ex.Detail.OuterXml);
}
}
}
Comentários
Os usuários podem adicionar propriedades de sistema personalizadas adicionais que não são reservadas pelo sistema. Se uma propriedade especificada na Property matriz não existir, ela será criada. Se existir um valor para uma propriedade, ele será substituído. Você não pode criar ou remover propriedades reservadas do sistema. Dependendo da propriedade do sistema que está sendo definida, a funcionalidade do servidor de relatório pode ser alterada. Para obter uma lista de propriedades reservadas do sistema, consulte Propriedades do sistema do servidor de relatório. Se ocorrerem erros, nenhuma propriedade será definida.
Você pode remover o valor de uma propriedade definindo a propriedade como um valor vazio.