Lenguaje

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

Definición

Establece una o más 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

El nombre completo de la ruta del objeto.

Properties
Property[]

Un array de Property objetos que define las propiedades y valores a establecer para el elemento.

Ejemplos

Para compilar el siguiente ejemplo de código, debes consultar el WSDL de Reporting Services e importar ciertos espacios de nombres. Para más información, consulte Ejemplos de Compilación y Ejecución de Código. El siguiente ejemplo de código establece una nueva descripción para el informe de ventas de la 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

La siguiente tabla muestra la información sobre cabeceras y permisos sobre esta operación.

Encabezados SOAP (En) BatchHeaderValue

(Fuera) ServerInfoHeaderValue
Permisos necesarios Depende del tipo de objeto:

- Folder: UpdateProperties
- Report: UpdateProperties
- Resource: UpdateProperties
- DataSource: UpdateProperties
- Model: UpdateProperties

Puedes crear nuevas propiedades definidas por el usuario para un elemento pasando un Property objeto como argumento de método. Para eliminar una propiedad de un elemento, establece esa propiedad en un valor vacío. No puedes eliminar propiedades reservadas. Para una lista de propiedades de elementos reservadas, consulte Propiedades de Elementos del Servidor de Informes.

Si una propiedad especificada no existe cuando se llama al SetProperties método, la propiedad se crea y se establece al valor que proporcionas. Si la propiedad ya existe, su valor se sobrescribe. Establecer un valor vacío para una propiedad que no existe no afecta al elemento ni a sus propiedades.

Si ocurre un error, no se establecen propiedades.

Se aplica a