ReportingService2005.SetProperties(String, 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 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.