Lists.AddAttachment method

Artigo
05/12/2015

Adiciona um anexo ao item de lista especificado na lista especificada.

Namespace: WebSvcLists
Assembly: STSSOAP (in STSSOAP.dll)

Syntax

'Declaração
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/AddAttachment", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/",  _
    ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function AddAttachment ( _
    listName As String, _
    listItemID As String, _
    fileName As String, _
    attachment As Byte() _
) As String
'Uso
Dim instance As Lists
Dim listName As String
Dim listItemID As String
Dim fileName As String
Dim attachment As Byte()
Dim returnValue As String

returnValue = instance.AddAttachment(listName, _
    listItemID, fileName, attachment)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/AddAttachment", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/", 
    ResponseNamespace = "https://schemas.microsoft.com/sharepoint/soap/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public string AddAttachment(
    string listName,
    string listItemID,
    string fileName,
    byte[] attachment
)

Parâmetros

listName
Type: System.String

Uma cadeia de caracteres que contém o título ou o GUID da lista.

listItemID
Type: System.String

Uma string que contém a ID do item para o qual os anexos são adicionados. Este valor não corresponder ao índice do item dentro da coleção de itens de lista.

fileName
Type: System.String

Uma string que contém o nome do arquivo a ser adicionado como um anexo.

attachment
Type: []

Uma matriz de bytes que contém o arquivo para anexar usando a codificação de base 64.

Valor retornado

Type: System.String
Uma cadeia de caracteres que contém a URL para o anexo, que subsequentemente pode ser usado para referenciar o anexo.

Examples

O exemplo de código a seguir adiciona um arquivo local como um anexo para um item de lista especificado. O exemplo usa um objeto System.IO.FileStream para ler o arquivo de origem em uma matriz de bytes que é passada como um parâmetro do método AddAttachment .

Este exemplo exige que um using (Visual c#) ou a ser incluído no espaço para nome System.IO de diretiva de Imports (Visual Basic). O exemplo também pressupõe a existência de uma caixa de texto na forma de aplicativo do Windows.

Dim srcUrl As String = textBox1.Text

If Not File.Exists(srcUrl) Then

    Throw New ArgumentException(String.Format("{0} does not exist", 
        srcUrl), "srcUrl")

End If

Dim fStream As FileStream = File.OpenRead(srcUrl)
Dim fileName As String = fStream.Name.Substring(3)
Dim contents(fStream.Length) As Byte
fStream.Read(contents, 0, CInt(fStream.Length))

fStream.Close()

Dim listService As New Web_Reference_Folder.Lists()
listService.Credentials = System.Net.CredentialCache.DefaultCredentials

Try

    Dim addAttach As String = listService.AddAttachment("List_Name", 
        "3", fileName, contents)

    MessageBox.Show(addAttach)

    Catch ex As System.Web.Services.Protocols.SoapException

        MessageBox.Show("Message:" + ControlChars.Lf + ex.Message + 
                ControlChars.Lf + _
            "Detail:" + ControlChars.Lf + ex.Detail.InnerText + 
                ControlChars.Lf + _
            "StackTrace:" + ControlChars.Lf + ex.StackTrace)

End Try

string srcUrl = textBox1.Text;

if (! File.Exists(srcUrl))
{
    throw new ArgumentException(String.Format("{0} does not exist", 
        srcUrl), "srcUrl");
}

FileStream fStream = File.OpenRead(srcUrl);
string fileName = fStream.Name.Substring(3);
byte[] contents = new byte[fStream.Length];
fStream.Read(contents, 0, (int)fStream.Length);
fStream.Close();

Web_Reference_Folder.Lists listService = 
    new Web_Reference_Folder.Lists();
listService.Credentials= System.Net.CredentialCache.DefaultCredentials;

try
{
    string addAttach = listService.AddAttachment("List_Name", "3", 
        fileName, contents);
    MessageBox.Show(addAttach);
}

catch (System.Web.Services.Protocols.SoapException ex)
{
    MessageBox.Show("Message:\n" + ex.Message + "\nDetail:\n" + 
        ex.Detail.InnerText + "\nStackTrace:\n" + ex.StackTrace);
}

Ver também

Referência

Lists class

Lists members

WebSvcLists namespace

Compartilhar via