Метод Lists.AddAttachment

Статья
05/13/2015

Добавление вложения в указанный элемент списка в указанный список.

Пространство имен: WebSvcLists
Сборка: STSSOAP (в STSSOAP.dll)

Синтаксис

'Декларация
<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
'Применение
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
)

Параметры

listName
Тип: System.String

Строка, содержащая название или идентификатор GUID для списка.

listItemID
Тип: System.String

Строка, содержащая идентификатор элемента, в которую добавляются вложения. Это значение не соответствует индекс элемента в коллекции элементов списка.

fileName
Тип: System.String

Строка, содержащая имя файла, чтобы добавить в качестве вложения.

attachment
Тип: []

Массив байтов, который содержит файл подключение с помощью кодировка base-64.

Возвращаемое значение

Тип: System.String
Строка, содержащая URL-адрес для вложения, которую впоследствии можно использовать для ссылки вложение.

Примеры

В следующем примере кода добавляет локальный файл в виде вложения в заданный элемент списка. В примере используется объект System.IO.FileStream для чтения к исходному файлу в массив байтов, который передается в качестве параметра метода AddAttachment .

В этом примере требуется директива Imports (Visual Basic) была включена в пространство имен System.IO или using (Visual C#). Кроме того, подразумевается наличие текстового поля в форме приложения 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);
}

См. также

Справочные материалы

Lists класс

Элементы Lists

Пространство имен WebSvcLists

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