ReportingService2005.GetProperties(String, Property[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значения одного или нескольких свойств элемента в базе данных сервера отчетов.
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()
Параметры
- Item
- String
Полное имя пути или идентификатор элемента.
- Properties
- Property[]
Массив объектов Property, содержащий свойства, для которых нужно получить значения.
Возвращаемое значение
Массив объектов Property, представляющий свойства указанного элемента.
Примеры
Чтобы скомпилировать этот пример кода, необходимо сослаться на Reporting Services WSDL и импортировать определенные пространства имен. Дополнительные сведения см. в разделе Примеры компиляции и выполнения кода. В следующем примере кода метод используется GetProperties для получения описания, связанного с отчетом о продажах компании:
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() );
}
}
}
Комментарии
В следующей таблице показаны сведения о заголовках и разрешениях для этой операции.
Заголовки SOAP | (In) ItemNamespaceHeaderValue (Out) ServerInfoHeaderValue |
Необходимые разрешения | Зависит от типа элемента: - Folder : ReadProperties- Report : ReadProperties- Resource : ReadProperties- DataSource : ReadProperties- Model : ReadProperties |
Значением по умолчанию, которое необходимо передать для этого аргумента, является полное имя пути. Чтобы указать идентификатор, необходимо задать ItemNamespaceHeader заголовок SOAP. Дополнительные сведения см. в разделе Настройка пространства имен элемента для метода GetProperties.
Используйте метод для GetProperties получения полного набора пользовательских и зарезервированных свойств. Чтобы получить стандартное подмножество зарезервированных свойств, используйте ListChildren метод . Список зарезервированных свойств элементов в базе данных сервера отчетов см. в разделе Свойства элементов сервера отчетов.
Properties
Если параметр имеет значение null
(Nothing
в Visual Basic), возвращаются все свойства указанного элемента. К ним относятся все определяемые пользователем и встроенные свойства, относящиеся к элементу.
Можно передать полное имя пути к элементу для Item
параметра или идентификатор элемента. Дополнительные сведения об использовании заголовков SOAP для этого см. в разделе Использование Reporting Services заголовков SOAP.