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

  • Référence

Définition

Espace de noms:
ReportService2005
Assembly:
ReportService2005.dll

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

Nom de chemin d'accès complet de l'élément.

Properties
Property[]

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 Reporting Services WSDL et importer certains espaces de noms. Pour plus d’informations, consultez Compilation et exécution d’exemples de code. L’exemple de code suivant définit une nouvelle description pour le rapport Ventes d’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 suivant présente les informations relatives aux en-têtes et aux autorisations sur cette opération.
En-têtes SOAP (In) BatchHeaderValue

(Out) ServerInfoHeaderValue
Autorisations requises Dépend du type d’élément :

- 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 en tant qu’argument de méthode. Pour supprimer une propriété d’un élément, définissez la propriété sur une valeur vide. Vous ne pouvez pas supprimer les propriétés réservées. Pour obtenir la liste des propriétés d’élément réservées, consultez Propriétés de l’élément du serveur de rapports.

Si une propriété spécifiée n’existe pas lorsque la SetProperties méthode est appelée, la propriété est créée et définie sur la valeur que vous fournissez. Si la propriété existe déjà, sa valeur est remplacée. La définition d’une valeur vide pour une propriété qui n’existe pas n’a aucun effet sur l’élément ou ses propriétés.

Si une erreur se produit, aucune propriété n’est définie.

S’applique à