Lists.AddAttachment メソッド (websvcLists)
添付ファイルを、特定のリストの指定したリスト アイテムに追加します。
名前空間: 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
リストのタイトルまたは GUID のどちらかを含む文字列。
- listItemID
添付ファイルの追加先となるアイテムの ID を含む文字列。この値は、リスト アイテムのコレクションに含まれるアイテムのインデックスには対応していません。
- fileName
添付ファイルとして追加するファイルの名前を含む文字列。
- attachment
Base 64 エンコードを使用して添付されるファイルを含むバイト配列。
戻り値
添付ファイルの URL を含む文字列。この URL は、後で添付ファイルを参照する場合に使用します。
例
次のコード例では、ローカル ファイルを添付ファイルとして、指定のリスト アイテムに追加します。この例では、System.IO.FileStream オブジェクトを使用して、添付元のファイルをバイト配列に読み込みます。このバイト配列は、AddAttachment メソッドのパラメータとして渡されます。
この例では、using (Visual C#) または Imports (Visual Basic) ディレクティブが System.IO 名前空間に含まれている必要があります。この例では、Windows アプリケーションのフォーム内に 1 つのテキスト ボックスが存在することを前提としています。
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);
}