ReportingService2005.GetProperties(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í.
Devuelve el valor de una o más propiedades de un elemento en la base de datos del servidor de informes.
public:
cli::array <ReportService2005::Property ^> ^ GetProperties(System::String ^ Item, cli::array <ReportService2005::Property ^> ^ Properties);
public ReportService2005.Property[] GetProperties(string Item, ReportService2005.Property[] Properties);
member this.GetProperties : string * ReportService2005.Property[] -> ReportService2005.Property[]
Public Function GetProperties (Item As String, Properties As Property()) As Property()
Parámetros
- Item
- String
El nombre completo de la ruta o el ID del artículo.
- Properties
- Property[]
Un array de Property objetos que contiene las propiedades para las que quieres recuperar valores.
Devoluciones
Un array de Property objetos que representa las propiedades del elemento especificado.
Ejemplos
Para compilar este 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 utiliza el GetProperties método para recuperar la descripción asociada al 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
' Create the property to retrieve.
Dim retrieveProp As New [Property]()
retrieveProp.Name = "Description"
Dim props(0) As [Property]
props(0) = retrieveProp
Try
Dim properties As [Property]() = rs.GetProperties("/SampleReports/Company Sales", props)
Dim prop As [Property]
For Each prop In properties
' Writes the description to the console.
Console.WriteLine(prop.Value)
Next prop
Catch e As SoapException
Console.WriteLine(e.Detail.InnerXml.ToString())
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;
// Create the property to retrieve.
Property retrieveProp = new Property();
retrieveProp.Name = "Description";
Property[] props = new Property[1];
props[0] = retrieveProp;
try
{
Property[] properties = rs.GetProperties("/SampleReports/Company Sales", props);
foreach (Property prop in properties)
{
// Writes the description to the console.
Console.WriteLine(prop.Value);
}
}
catch ( SoapException e )
{
Console.WriteLine( e.Detail.InnerXml.ToString() );
}
}
}
Comentarios
La siguiente tabla muestra la información sobre cabeceras y permisos sobre esta operación.
| Encabezados SOAP | (En) ItemNamespaceHeaderValue (Fuera) ServerInfoHeaderValue |
| Permisos necesarios | Depende del tipo de objeto: - Folder: ReadProperties- Report: ReadProperties- Resource: ReadProperties- DataSource: ReadProperties- Model: ReadProperties |
El valor por defecto que debe pasarse para este argumento es el nombre completo del camino. Para proporcionar un ID, debes establecer la ItemNamespaceHeader cabecera SOAP. Para más información, consulte Establecer el espacio de nombres de elementos para el método GetProperties.
Utiliza el GetProperties método para recuperar el conjunto completo de propiedades definidas y reservadas por el usuario. Para recuperar el subconjunto estándar de propiedades reservadas, utilice el ListChildren método. Para una lista de las propiedades reservadas de los elementos en la base de datos del servidor de informes, consulte Propiedades de los elementos del servidor de informes.
Si el Properties parámetro es null (Nothing en Visual Basic), se devuelven todas las propiedades del elemento especificado. Estas incluyen todas las propiedades definidas por el usuario e integradas que son específicas del artículo.
Puedes pasar el nombre completo de la ruta del elemento para el Item parámetro o puedes pasar el ID del elemento. Para más información sobre el uso de cabeceras SOAP para lograr esto, consulte Uso de Reporting Services SOAP Headers.