Share via


SPSite constructor (String)

Inicializa uma nova instância da classe SPSite , com base na URL especificada.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
Public Sub New ( _
    requestUrl As String _
)
'Uso
Dim requestUrl As String

Dim instance As New SPSite(requestUrl)
public SPSite(
    string requestUrl
)

Parâmetros

  • requestUrl
    Type: System.String

    A URL absoluta do conjunto de sites.

Exceptions

Exception Condition
FileNotFoundException

Não foi possível encontrar o conjunto de sites.

Comentários

A URL que é passada para o construtor SPSite não é necessário corresponder exatamente a uma URL do conjunto de sites. Veja os exemplos abaixo.

Aviso

Esse construtor é permitido em soluçăos em área restrita. Nesse caso, o valor do parâmetro requestUrl deve ser resolvido para o conjunto de sites pai no qual o soluçăo em área restrita é implantado. Se o valor do parâmetro requestUrl resolve a URL de qualquer outro conjunto de sites, o construtor lançará uma exceção porque um soluçăo em área restrita não tem permissão para acessar os objetos SharePoint fora de seu conjunto de sites de hospedagem.

Examples

O exemplo de código a seguir retorna o conjunto de sites está localizado em https://Server_Name/sites/Site_Name , mesmo que a URL que é passada para o construtor não coincide com a URL do conjunto de sites.

Using oSiteCollection As New SPSite("http://Server_Name/sites/Site_Name/Subsite_Name/default.aspx")
    ...
End Using
using (SPSite oSiteCollection = new SPSite("http://Server_Name/sites/Site_Name/Subsite_Name/default.aspx"))
{
    ...
}

O exemplo de código a seguir cria um objeto SPSite usando System.Environment.MachineName.

Using oSiteCollection As New SPSite("http://" + System.Environment.MachineName + "/sites/Site_Name")
    ...
End Using
using (SPSite oSiteCollection = new SPSite("http://" + System.Environment.MachineName + "/sites/Site_Name"))
{
    ...
}

Dica

Determinados objetos implementam a interface IDisposable , e você deve evitar reter esses objetos na memória depois que eles não são mais necessários. Para obter informações sobre boas práticas de codificação, consulte Disposing Objects.

Ver também

Referência

SPSite class

SPSite members

SPSite overload

Microsoft.SharePoint namespace