Поделиться через


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.

Применяется к