Поделиться через


Свойство Project.CustomFields

Получает коллекцию проекта настраиваемого поля, имеющие значения, заданные для проекта.

Пространство имен:  Microsoft.ProjectServer.Client
Сборка:  Microsoft.ProjectServer.Client (в Microsoft.ProjectServer.Client.dll)

Синтаксис

'Декларация
<RemoteAttribute> _
Public ReadOnly Property CustomFields As CustomFieldCollection
    Get
'Применение
Dim instance As Project
Dim value As CustomFieldCollection

value = instance.CustomFields
[RemoteAttribute]
public CustomFieldCollection CustomFields { get; }

Значение свойства

Тип: Microsoft.ProjectServer.Client.CustomFieldCollection
Коллекция объектов CustomField .

Замечания

Свойство CustomFields не включает project настраиваемые поля, которые не имеют значение, установленное в проекте. Например если проект не содержит значения для текста настраиваемого поля проекта с именем SomeText, этого настраиваемого поля не включается в коллекции CustomFields для этого проекта.

Примеры

В следующем примере кода запрашивает каждого опубликованного корпоративного проекта для ее коллекцию настраиваемых полей. Список GUID и имя проекта, имя и значение каждого настраиваемого поля и внутреннее имя каждого настраиваемого поля в проекте как ключ в пары "ключ значение". Если настраиваемое поле использует таблицу подстановки, FieldValues элемент содержит внутреннее имя записи таблицы подстановки. Если настраиваемое поле для нескольких значений текстового поля, в примере перечислены значения и внутреннее имя каждой записи в таблице подстановки для этого настраиваемого поля в проекте. Если настраиваемое поле не использует таблицу подстановки, значение — это просто значение настраиваемого поля.

Внутреннее имя настраиваемого поля — это строка со значением "Custom_ [GUID]", например, Custom_9d77d62aa92e4d40adc8446c90eb7456. Внутреннее имя записи в таблице подстановки — это строка со значением "Entry_ [GUID]", например, Entry_4a2750309d91e21193f90021704e28a0.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Microsoft.ProjectServer.Client;

namespace GetProjectFieldValues
{
    class Program
    {
        private const string pwaPath = "https://ServerName/pwa";    // Change the path for Project Web App.

        // Set the Project Server client context.
        private static ProjectContext projContext;

        static void Main(string[] args)
        {
            projContext = new ProjectContext(pwaPath);

            // Get the list of published projects in Project Web App.
            projContext.Load(projContext.Projects);
            projContext.ExecuteQuery();

            Console.WriteLine("\t\tProject ID\t     :\tProject name");

            if (projContext.Projects.Count > 0)
            {
                for (int i = 0; i < projContext.Projects.Count; i++)
                {
                    var pubProj = projContext.Projects[i].IncludeCustomFields;
                    projContext.Load(pubProj);
                    projContext.Load(pubProj.CustomFields);
                    projContext.ExecuteQuery();

                    Console.WriteLine("\n{0} :\t{1}", pubProj.Id.ToString(), pubProj.Name);
                    int numCFs = pubProj.CustomFields.Count;
                    Console.WriteLine("Number of custom fields: {0}", numCFs.ToString());

                    Dictionary<string, object> projDict = pubProj.FieldValues;

                    // Variables to compare with custom field types:
                    string textValue = "";                  // TEXT - no lookup table
                    String[] lutTextValues = { "" };        // TEXT - lookup table
                    DateTime dateValue = DateTime.MinValue; // DATE - no lookup table

                    foreach (KeyValuePair<string, object> kvp in projDict)
                    {
                        object oVal = kvp.Value;
                        string keyStr = kvp.Key;

                        var projCFs = projContext.LoadQuery(pubProj.CustomFields
                            .Where(cf => cf.InternalName == keyStr));
                        projContext.ExecuteQuery();

                        Console.WriteLine("\n    Custom field: '{0}'; FieldType = {1};\n\tInternalName = {2}",
                            projCFs.First().Name, projCFs.First().FieldType.ToString(), keyStr);

                        // Check whether the custom field is a simple text field.
                        if (object.ReferenceEquals(oVal.GetType(), textValue.GetType()))
                        {
                            textValue = (string)oVal;
                            Console.WriteLine("\tSingle-line string value = {0}", textValue.ToString());
                        }
                        // Check whether the custom field is a text (or multivalue text) field from a lookup table.
                        else if (object.ReferenceEquals(oVal.GetType(), lutTextValues.GetType()))
                        {
                            projContext.Load(projCFs.First().LookupTable);
                            projContext.ExecuteQuery();
                            string lutName = projCFs.First().LookupTable.Name;

                            Console.WriteLine("\tLookup table: {0}", lutName);

                            var luts = projContext.LoadQuery(projContext.LookupTables
                                .Where(lut => lut.Name == lutName));
                            projContext.ExecuteQuery();

                            lutTextValues = (string[])oVal;

                            for (var j = 0; j < lutTextValues.Count(); j++)
                            {
                                var entries = projContext.LoadQuery(luts.First().Entries
                                    .Where(e => e.InternalName == lutTextValues[j]));
                                projContext.ExecuteQuery();
                                Console.WriteLine("\t    Entry({0}): String value = {1};\n\t\t  InternalName = {2}",
                                    j, entries.First().FullValue, lutTextValues[j]);
                            }
                        }
                        // Check whether the custom field is a date.
                        else if (object.ReferenceEquals(oVal.GetType(), dateValue.GetType()))
                        {
                            dateValue = (DateTime)oVal;

                            Console.WriteLine("\tDate value = {0}", dateValue.ToString());
                        }
                        // Add other cases for cost, duration, flag, and number custom fields,
                        // with and without lookup tables.
                    }
                }
            }
            Console.Write("\nPress any key to exit: ");
            Console.ReadKey(false);
        }
    }
}

Например проект с именем TestProject9 имеет значение настраиваемого поля отделы проекта, настраиваемого поля для нескольких значений текста с три значения запись таблицы подстановки, настраиваемое поле простого текста и настраиваемые поля даты. Так как отделы проекта по умолчанию является встроенной настраиваемого поля GUID для настраиваемого поля отделы проекта экземпляры Project Web App — 9d77d62a-a92e-4d40-adc8-446c90eb7456. Ниже приведен выходные данные в примере приложения GetProjectFieldValues .

b846e947-29e0-43eb-b5c6-5ddeaf08d5c0 :  TestProject9
Number of custom fields: 4

    Custom field: 'Project Departments'; FieldType = TEXT;
        InternalName = Custom_9d77d62aa92e4d40adc8446c90eb7456
        Lookup table: Department
            Entry(0): String value = Test Dept 1;
                  InternalName = Entry_bbc07ff5b06de21193f40021704e28a0

    Custom field: 'ProjectMVText'; FieldType = TEXT;
        InternalName = Custom_9295a8759d91e21193f90021704e28a0
        Lookup table: TestTextMV
            Entry(0): String value = First.001;
                  InternalName = Entry_4a2750309d91e21193f90021704e28a0
            Entry(1): String value = Second.002;
                  InternalName = Entry_4d2750309d91e21193f90021704e28a0
            Entry(2): String value = Third;
                  InternalName = Entry_4f2750309d91e21193f90021704e28a0

    Custom field: 'Test Project Date'; FieldType = DATE;
        InternalName = Custom_37f61601a991e21193f90021704e28a0
        Date value = 3/29/2013 8:00:00 AM

    Custom field: 'Test project simple text'; FieldType = TEXT;
        InternalName = Custom_8bf7eed5cc94e21193f90021704e28a0
        Single-line string value = This is a line of text

См. также

Справочные материалы

Project класс

Элементы Project

Пространство имен Microsoft.ProjectServer.Client