Langue

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

Définition

Définit une ou plusieurs propriétés d’un élément spécifié.

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())

Paramètres

Item
String

Le nom complet du chemin de l’objet.

Properties
Property[]

Un tableau d’objets Property qui définit les propriétés et valeurs à définir pour l’élément.

Exemples

Pour compiler l’exemple de code suivant, vous devez référencer le WSDL de Reporting Services et importer certains espaces de noms. Pour plus d’informations, voir Exemples de compilation et exécution de code. L’exemple de code suivant établit une nouvelle description pour le rapport de ventes de l’entreprise :

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);  
      }  
   }  
}  

Remarques

Le tableau ci-dessous présente les informations sur l’en-tête et les autorisations concernant cette opération.

En-têtes SOAP (En) BatchHeaderValue

(Dehors) ServerInfoHeaderValue
Autorisations requises Cela dépend du type d’objet :

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

Vous pouvez créer de nouvelles propriétés définies par l’utilisateur pour un élément en passant un Property objet comme argument de méthode. Pour retirer une propriété d’un élément, fixez la propriété à une valeur vide. Vous ne pouvez pas supprimer les propriétés réservées. Pour une liste des propriétés réservées des objets, voir Propriétés des éléments du serveur de rapport.

Si une propriété spécifiée n’existe pas au moment de l’appel de la SetProperties méthode, la propriété est créée et fixée à la valeur que vous fournissez. Si la propriété existe déjà, sa valeur est écrasée. Définir une valeur vide pour une propriété qui n’existe pas n’a aucun effet sur l’objet ni sur ses propriétés.

En cas d’erreur, aucune propriété n’est définie.

S’applique à