SPWebApplication Class
Represents an Internet Information Services (IIS) load-balanced Web application that is installed on the server farm.
Inheritance Hierarchy
System.Object
Microsoft.SharePoint.Administration.SPAutoSerializingObject
Microsoft.SharePoint.Administration.SPPersistedObject
Microsoft.SharePoint.Administration.SPPersistedUpgradableObject
Microsoft.SharePoint.Administration.SPWebApplication
Microsoft.SharePoint.Administration.SPAdministrationWebApplication
Namespace: Microsoft.SharePoint.Administration
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: No
Syntax
'Declaration
<GuidAttribute("113FB569-7520-4651-8FC4-E9F4F5887618")> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public Class SPWebApplication _
Inherits SPPersistedUpgradableObject _
Implements IBackupRestore, IMigratable
'Usage
Dim instance As SPWebApplication
[GuidAttribute("113FB569-7520-4651-8FC4-E9F4F5887618")]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public class SPWebApplication : SPPersistedUpgradableObject,
IBackupRestore, IMigratable
Remarks
All servers that run the parent Web service (SPWebService) of the Web application must have a provisioned instance of the application. All instances of the application must be configured identically.
Various objects in the Microsoft.SharePoint.Administration namespace provide a WebApplication property through which you can access the containing Web application. Use the WebApplication property of the SPSite class to get the Web application that contains a site collection. To get the Web application of the current HTTP context, you can use SPContext.Current.Site.WebApplication.
Use the WebApplications property of the SPWebService class to return an SPWebApplicationCollection object that represents the collection of Web applications within a Web service. Use an indexer to return a single Web application from the collection. For example, if the collection is assigned to a variable named myWebApplications, use myWebApplications[index] in C#, or myWebApplications(index) in Visual Basic, where index is either the name or the GUID that identifies the Web application.
Examples
The following example uses the Lookup method to change the maximum file size and per-user alert settings for a specified Web application.
Dim oWebApplication As SPWebApplication = SPWebApplication.Lookup(New Uri("http://MyServer:989"))
oWebApplication.MaximumFileSize = 100
oWebApplication.AlertsMaximum = 1000
oWebApplication.Update()
SPWebApplication oWebApplication = SPWebApplication.Lookup(new Uri("http://MyServer:989"));
oWebApplication.MaximumFileSize = 100;
oWebApplication.AlertsMaximum = 1000;
oWebApplication.Update();
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.