Idioma

ReportingService2006.SetProperties(String, Property[]) Método

Definição

Define uma ou mais propriedades de um item especificado.

public:
 void SetProperties(System::String ^ Item, cli::array <ReportService2006::Property ^> ^ Properties);
public void SetProperties(string Item, ReportService2006.Property[] Properties);
member this.SetProperties : string * ReportService2006.Property[] -> unit
Public Sub SetProperties (Item As String, Properties As Property())

Parâmetros

Item
String

A URL totalmente qualificada do item, incluindo o nome e extensão do arquivo.

Properties
Property[]

Um array de Property objetos que define as propriedades e valores a serem definidos para o item.

Exemplos

using System;  
using System.Collections.Generic;  
using System.IO;  
using System.Text;  
using System.Web;  
using System.Web.Services;  
using System.Web.Services.Protocols;  

class Sample  
{  
    static void Main(string[] args)  
    {  
        ReportingService2006 rs = new ReportingService2006();  
        rs.Url = "http://<Server Name>/_vti_bin/ReportServer/" +  
            "ReportService2006.asmx";  
        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 = "http://<Server Name>/Docs/Documents/" +  
            "AdventureWorks Sample Reports/Sales Order Detail.rdl";  

        try  
        {  
            rs.SetProperties(itemPath, props);  
            Console.WriteLine("New description set on item {0}.",   
                itemPath);  
        }  
        catch (SoapException ex)  
        {  
            Console.WriteLine(ex.Detail.OuterXml);  
        }  
    }  
}  
Imports System  
Imports System.IO  
Imports System.Text  
Imports System.Web.Services  
Imports System.Web.Services.Protocols  

Class Sample  

    Public Shared Sub Main()  

        Dim rs As New ReportingService2006()  
        rs.Url = "http://<Server Name>/_vti_bin/ReportServer/" + _  
            "ReportService2006.asmx"  
        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 = "http://<Server Name>/Docs/" + _  
            "Documents/AdventureWorks Sample Reports/" + _  
            "Sales Order Detail.rdl"  

        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  

End Class  

Comentários

A tabela abaixo mostra informações sobre cabeçalhos e permissões sobre esta operação.

Cabeçalhos SOAP (Em) TrustedUserHeaderValue

(Fora) ServerInfoHeaderValue
Permissões necessárias <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems>

Você pode criar novas propriedades definidas pelo usuário para um item passando um Property objeto como argumento de método. Para remover uma propriedade de um item, defina a propriedade para um valor vazio. Você não pode remover propriedades reservadas. Para uma lista das propriedades dos itens reservados, veja Propriedades do Item do Servidor de Relatórios.

Se uma propriedade especificada não existir quando o SetProperties método for chamado, a propriedade é criada e definida para o valor que você fornece. Se a propriedade já existir, seu valor é sobrescrevido. Definir um valor vazio para uma propriedade que não existe não afeta o item nem suas propriedades.

Se ocorrer um erro, nenhuma propriedade é definida.

Retorna rsOperationNotSupportedSharePointMode erro quando Item="/".

Aplica-se a