ReportingService2005.SetProperties(String, Property[]) Método

Definición

Espacio de nombres:

ReportService2005

Ensamblado:

ReportService2005.dll

Establece una o varias propiedades de un elemento especificado.

public:
 void SetProperties(System::String ^ Item, cli::array <ReportService2005::Property ^> ^ Properties);

public void SetProperties (string Item, ReportService2005.Property[] Properties);

member this.SetProperties : string * ReportService2005.Property[] -> unit

Public Sub SetProperties (Item As String, Properties As Property())

Parámetros

Item

String

Nombre de la ruta de acceso completa del elemento.

Properties

Property[]

Matriz de objetos Property que define las propiedades y valores que se establecerán para el elemento.

Ejemplos

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 establece una nueva descripción para el informe Ventas de empresa:

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 props(0) As [Property]  
      Dim setProp As New [Property]()  
      setProp.Name = "Description"  
      setProp.Value = "Sales by quarter and product category."  
      props(0) = setProp  

      Dim itemPath As String = "/SampleReports/Company Sales"  

      Try  
         rs.SetProperties(itemPath, props)  
         Console.WriteLine("New description set on item {0}.", itemPath)  

      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[] props = new Property[1];  
      Property setProp = new Property();  
      setProp.Name = "Description";  
      setProp.Value = "Sales by quarter and product category.";  
      props[0] = setProp;  

      string itemPath = "/SampleReports/Company Sales";   

      try  
      {  
         rs.SetProperties(itemPath, props);  
         Console.WriteLine("New description set on item {0}.", itemPath);  
      }  

      catch (SoapException ex)  
      {  
         Console.WriteLine(ex.Detail.OuterXml);  
      }  
   }  
}  

Comentarios

En la siguiente tabla se muestra la información de encabezado y de permisos de esta operación.

Encabezados SOAP	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Permisos necesarios	Depende del tipo de elemento: - Folder: UpdateProperties - Report: UpdateProperties - Resource: UpdateProperties - DataSource: UpdateProperties - Model: UpdateProperties

Puede crear nuevas propiedades definidas por el usuario para un elemento pasando un Property objeto como argumento de método. Para quitar una propiedad de un elemento, establezca la propiedad en un valor vacío. No se pueden quitar las propiedades reservadas. Para obtener una lista de las propiedades reservadas de elementos, vea Propiedades del elemento del servidor de informes.

Si no existe una propiedad especificada cuando se llama al SetProperties método , la propiedad se crea y se establece en el valor proporcionado. Si la propiedad ya existe, se sobrescribe su valor. Establecer un valor vacío para una propiedad que no existe no tiene ningún efecto en el elemento ni en sus propiedades.

Si se produce un error, no se establecen propiedades.