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.StringA 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.