ReportingService2005.SetSystemProperties(Property[]) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Establece una o más propiedades del 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[]
Matriz de objetos Property que define las propiedades y valores del sistema que se van a establecer para un servidor de informes.
Ejemplos
En la siguiente tabla se muestra la información de encabezado y de permisos de esta operación.
Encabezados SOAP | (Out) ServerInfoHeaderValue |
Permisos necesarios | UpdateSystemProperties (Sistema) |
Para compilar el ejemplo de código siguiente, debe hacer referencia al Reporting Services WSDL e importar determinados espacios de nombres. Para obtener más información, vea Compilar y ejecutar ejemplos de código. En el ejemplo de código siguiente se crea una nueva propiedad del sistema denominada Description 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
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);
}
}
}
Comentarios
Los usuarios pueden agregar propiedades del sistema personalizadas adicionales que no están reservadas por el sistema. Si no existe una propiedad especificada en la Property matriz, se crea. Si existe un valor para una propiedad, se sobrescribe. No se pueden crear ni quitar propiedades reservadas del sistema. En función de la propiedad del sistema que se establezca, la funcionalidad del servidor de informes puede cambiar. Para obtener una lista de las propiedades reservadas del sistema, vea Propiedades del sistema del servidor de informes. Si se producen errores, no se establece ninguna propiedad.
Puede quitar el valor de una propiedad estableciendo la propiedad en un valor vacío.