SaveWebPart method

WebPartPagesWebService.SaveWebPart method

Saves changes to an existing dynamic Web Part.

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

[SoapDocumentMethodAttribute("", RequestNamespace = "", 
	ResponseNamespace = "", 
	Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public void SaveWebPart(
	string pageUrl,
	Guid storageKey,
	string webPartXml,
	Storage storage


Type: System.String

The URL of the source page.

Type: System.Guid

A GUID that identifies the Web Part.

Type: System.String

A string containing the XML information on the Web Part.

Type: WebSvcwebpartpages.Storage

A Storage value indicating how the Web Part is stored

To access the WebPartPagesWebService service and its methods, set a Web reference to http://Virtual_Server_Name:Port_Number/_vti_adm/WebPartPages.asmx.

The following code example shows a locally defined AddWebPart method that adds a Web Part and then modifies it by calling the AddWebPart and SaveWebPart methods of the Web Part Pages service through a proxy. This code example and the proxy are part of a larger example provided for the Web Part Pages service.

private void AddWebPart()
     // NOTE: The Web Service we are using is defined on MyServer/_vti_bin
     // Declare and initialize a variable for the WebPartPages Web Service.
     WebpartpagesSvc.WebPartPagesWebService svc = new Microsoft.Samples.WebPartPagesSvcClient.WebpartpagesSvc.WebPartPagesWebService();
     // Authenticate the current user by passing their default
     // credentials to the Web Service from the system credential cache.
     svc.Credentials = System.Net.CredentialCache.DefaultCredentials;
     string pageUrl = "http://MyServer/Shared%20Documents/SampleStart.aspx";
     // Create Web Part XML inline. 
     string webPartXml = "<?xml version=\"1.0\" encoding=\"utf-16\"?>\n" +
     "<WebPart xmlns:xsd=\"\" xmlns:xsi=\"\" xmlns=\"\">\n" +
     "<Title>Content Editor Web Part</Title>\n  " +
     "<FrameType>Default</FrameType>\n  " +
     "<Description>Use for formatted text, tables, and images.</Description>\n  " +
     "<IsIncluded>true</IsIncluded>\n  " +
     "<ZoneID>Header</ZoneID>\n  " +
     "<PartOrder>1</PartOrder>\n  " +
     "<FrameState>Normal</FrameState>\n  " +
     "<Height />\n  " +
     "<Width />\n  " +
     "<AllowRemove>true</AllowRemove>\n  " +
     "<AllowZoneChange>true</AllowZoneChange>\n  " +
     "<AllowMinimize>true</AllowMinimize>\n  " +
     "<IsVisible>true</IsVisible>\n  " +
     "<DetailLink />\n  " +
     "<HelpLink />\n  " +
     "<Dir>Default</Dir>\n  " +
     "<PartImageSmall />\n  " +
     "<MissingAssembly />\n  " +
     "<PartImageLarge>/_layouts/images/mscontl.gif</PartImageLarge>\n  " +
     "<IsIncludedFilter />\n  " +
     "<Assembly>Microsoft.SharePoint, Version=, Culture=neutral, PublicKeyToken=71e9bce111e9429c</Assembly>\n  " +
     "<TypeName>Microsoft.SharePoint.WebPartPages.ContentEditorWebPart</TypeName>\n  " +
     "<ContentLink xmlns=\"\" />\n  " +
     "<Content xmlns=\"\"><![CDATA[<P>Hello</P>]]></Content>\n  " +
     "<PartStorage xmlns=\"\" />\n</WebPart>";

     // Add Web Part, store the new Web Part GUID into a variable.
     Guid newPartId = svc.AddWebPart(pageUrl, webPartXml,         WebpartpagesSvc.Storage.Shared);
     // Edit the Web Part XML.
     System.Text.StringBuilder sb = new System.Text.StringBuilder(webPartXml);
     sb.Replace("Hello", "Hello world!!");
     sb.Replace("<Title>Content Editor Web Part</Title>", "<Title>Autogenerated Web Part!</Title>");

     // Call SaveWebPart to update the contents of the Web Part XML.
     svc.SaveWebPart(pageUrl, newPartId, sb.ToString(),        WebpartpagesSvc.Storage.Shared);
     Console.WriteLine("A new Web Part with ID [{0}] was added to the page [{1}]",        newPartId.ToString(), pageUrl);
     Console.WriteLine("-----Hit enter-----");
© 2016 Microsoft