SPRegionalSettings - Classe
Représente les paramètres régionaux qui sont utilisés sur le serveur qui est en cours d'exécution Microsoft SharePoint Foundation.
Hiérarchie d’héritage
System.Object
Microsoft.SharePoint.SPRegionalSettings
Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Class SPRegionalSettings
'Utilisation
Dim instance As SPRegionalSettings
public class SPRegionalSettings
Remarques
Utilisez la propriété RegionalSettings de la classe SPWeb pour renvoyer un objet SPRegionalSettings qui représente les paramètres régionaux d'un site Web. Vous pouvez renvoyer les mêmes paramètres régionaux via le constructeur SPRegionalSettings . Utilisez la propriété RegionalSettings de la classe SPUser pour renvoyer un objet SPRegionalSettings qui représente les paramètres régionaux d'un utilisateur.
Si vous modifiez les paramètres régionaux d'un site Web via la propriété Locale et appelez la méthode Update pour appliquer les modifications, les propriétés suivantes sur l'objet de site Web existant reflètent les paramètres régionaux d'origine, pas les nouveaux. Pour récupérer les nouveaux paramètres, créez un nouvel objet de site Web, vous pouvez effectuer à l'aide de la méthode OpenWeb() , pour accéder aux propriétés de paramètres régionaux (par exemple, newWebSiteObject.RegionalSettings.DateFormat).
Exemples
L'exemple de code suivant crée un sous-site au sein d'une collection de sites, modifie le format de date qui est utilisé dans les paramètres régionaux pour le nouveau site Web, puis affiche le nouveau paramètre.
Dim siteCollection As New SPSite("https://localhost")
Try
Dim rootWebSite As SPWeb = siteCollection.RootWeb
Dim newSubSite As SPWeb = rootWebSite.Webs.Add("MySite")
newSubSite.Locale = CultureInfo.CreateSpecificCulture("ja-JP")
newSubSite.Update()
Dim webSite As SPWeb = siteCollection.OpenWeb(rootWebSite.Webs("MySite").ID)
Response.Write(webSite.RegionalSettings.DateFormat)
rootWebSite.Dispose()
newSubSite.Dispose()
webSite.Dispose()
Finally
siteCollection.Dispose()
End Try
using (SPSite oSiteCollection = new SPSite("https://localhost"))
{
SPWeb oWebsiteRoot = oSiteCollection.RootWeb;
SPWeb oWebsiteNew = oWebsiteRoot.Webs.Add("MySite");
oWebsiteNew.Locale = CultureInfo.CreateSpecificCulture("ja-JP");
oWebsiteNew.Update();
SPWeb oWebsiteCurrent = oSiteCollection.OpenWeb(oWebsiteRoot.Webs["MySite"].ID);
Response.Write(oWebsiteCurrent.RegionalSettings.DateFormat);
oWebsiteRoot.Dispose();
oWebsiteNew.Dispose();
oWebsiteCurrent.Dispose();
}
Notes
Certains objets implémentent l'interface IDisposable , et vous devez éviter de conserver ces objets dans la mémoire après que qu'ils ne sont plus nécessaires. Pour plus d'informations sur les bonnes pratiques de codage, consultez Disposing Objects.
Cohérence de thread
Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.