Project.ReadProjectList - Méthode
Obtient le nom du projet, le GUID et le type de chaque projet qui est disponible sur l'instance de Project Web App.
Espace de noms : WebSvcProject
Assembly : ProjectServerServices (dans ProjectServerServices.dll)
Syntaxe
'Déclaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/Project/ReadProjectList", RequestNamespace := "https://schemas.microsoft.com/office/project/server/webservices/Project/", _
ResponseNamespace := "https://schemas.microsoft.com/office/project/server/webservices/Project/", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function ReadProjectList As ProjectDataSet
'Utilisation
Dim instance As Project
Dim returnValue As ProjectDataSet
returnValue = instance.ReadProjectList()
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/office/project/server/webservices/Project/ReadProjectList", RequestNamespace = "https://schemas.microsoft.com/office/project/server/webservices/Project/",
ResponseNamespace = "https://schemas.microsoft.com/office/project/server/webservices/Project/",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public ProjectDataSet ReadProjectList()
Valeur renvoyée
Type : WebSvcProject.ProjectDataSet
Le schéma ProjectDataSet contient uniquement le tableau Project , avec les champs suivants : PROJ_UID, PROJ_NAMEet PROJ_TYPE.
Remarques
ReadProjectStatus peut être utilisée pour obtenir une liste des projets qui sont visibles à tous les utilisateurs Project Server. Parce qu'elle obtient une liste de tous les projets, ReadProjectList est conçu pour une utilisation avec des utilitaires d'administration et requiert un niveau élevé d'autorisations.
Une application doit être connectée à une instance de Project Server avec les informations d'identification utilisateur valide avant de pouvoir exécuter ReadProjectList.
Utilisez la propriété Project de l' ProjectDataSet pour accéder à la liste des projets.
Autorisations Project Server
Autorisation |
Description |
|---|---|
Permet à un utilisateur de gérer le Service de mise en attente. Autorisation globale. |
|
Permet à un utilisateur de gérer les paramètres de sécurité. Autorisation globale. |
Exemples
L'exemple suivant crée un exemple de projet, puis répertorie les projets qui sont détectés.
Pour plus d'informations sur l'exécution de cet exemple de code critiques, voir Prerequisites for Reference Code Samples.
using System;
using System.Collections.Generic;
using System.Text;
using System.Net;
using System.Web.Services.Protocols;
using System.Data;
using System.Threading;
using PSLibrary = Microsoft.Office.Project.Server.Library;
namespace Microsoft.SDK.Project.Samples.ReadProjectList
{
class Program
{
[STAThread]
static void Main()
{
try
{
const string PROJECT_SERVER_URI = "https://ServerName/ProjectServerName/";
const string PROJECT_SERVICE_PATH = "_vti_bin/psi/project.asmx";
// Set up the web service objects.
SvcProject.Project projectSvc = new SvcProject.Project();
projectSvc.Url = PROJECT_SERVER_URI + PROJECT_SERVICE_PATH;
projectSvc.Credentials = CredentialCache.DefaultCredentials;
// Read and display the project list.
Console.WriteLine("Reading the project list");
SvcProject.ProjectDataSet projectDs = projectSvc.ReadProjectList();
foreach (SvcProject.ProjectDataSet.ProjectRow projectRow in projectDs.Project)
{
Console.WriteLine(projectRow.PROJ_NAME + " (" + projectRow.PROJ_UID + ")");
}
}
catch (SoapException ex)
{
PSLibrary.PSClientError error = new PSLibrary.PSClientError(ex);
PSLibrary.PSErrorInfo[] errors = error.GetAllErrors();
string errMess = "==============================\r\nError: \r\n";
for (int i = 0; i < errors.Length; i++)
{
errMess += "\n" + ex.Message.ToString() + "\r\n";
errMess += "".PadRight(30, '=') + "\r\nPSCLientError Output:\r\n \r\n";
errMess += errors[i].ErrId.ToString() + "\n";
for (int j = 0; j < errors[i].ErrorAttributes.Length; j++)
{
errMess += "\r\n\t" + errors[i].ErrorAttributeNames()[j] + ": " + errors[i].ErrorAttributes[j];
}
errMess += "\r\n".PadRight(30, '=');
}
Console.ForegroundColor = ConsoleColor.Red;
Console.WriteLine(errMess);
}
catch (WebException ex)
{
string errMess = ex.Message.ToString() +
"\n\nLog on, or check the Project Server Queuing Service";
Console.ForegroundColor = ConsoleColor.Red;
Console.WriteLine("Error: " + errMess);
}
catch (Exception ex)
{
Console.ForegroundColor = ConsoleColor.Red;
Console.WriteLine("Error: " + ex.Message);
}
finally
{
Console.ResetColor();
Console.WriteLine("\r\n\r\nPress any key...");
Console.ReadKey();
}
}
}
}