24

什么是 WinRT 语言投影，它们用于什么？

4

4 回答 4

16

WinRT 中的“Projections”是“Bindings”的另一个词。

WinRT 语言投影是支持的每种语言的 WinRT 绑定。

欲了解更多信息，请查看：

WinRT 揭秘 - Miguel de Icaza

于 2011-09-15T14:55:55.240 回答
16

Windows 运行时投影是在每种语言中公开 Windows 运行时 API 的方式。这可能是在编译时（如在 C++ 中）或在运行时（如在 JavaScript 中）或组合时（如在 C# 中）。每种语言都决定如何最好地呈现 WinRT API。大多数时候是直接暴露，但其他时候可能会发生包装或重定向。代表和活动就是一个很好的例子。在 C# 中，它们显示为 C# 委托/事件，而不是特定于 WinRT 的类型。字符串同样被重新映射为本地语言字符串类型，而不是底层的 hstring 类型。

于 2011-09-16T04:23:57.390 回答
6

语言投影是一种以语言友好的方式向您公开 Windows 运行时 API 的方法。

例如，创建Windows.Globalization.Calendar对象的底层方法是调用：

IInspectable instance;
HRESULT hr = RoActivateInstance(StringToHSTRING("Windows.Globalization.Calendar"), out instance);
if (Failed(hr))
   throw new ComException(hr);

ICalendar calendar;
hr = instance.QueryInterface(IID_ICalendar, out calendar);
if (Failed(hr))
   throw new ComException(hr);

这就是大多数语言所说的“构造函数”。但是大多数语言已经有了“创建对象”的语法。

如果你在 C# 中，你有：

Calendar calendar = new Calendar();

如果你在帕斯卡，你有：

calendar: TCalendar;

calendar := TCalendar.Create;

因此，让我们围绕它创建一个类似 C# 的包装器（或投影）：

class Calendar : Object
{
   private ICalendar _calendar;

   //constructor
   void Calendar() : base()
   { 
      IInspectable instance;
      HRESULT hr = RoActivateInstance(StringToHSTRING("Windows.Globalization.Calendar"), out instance);
      if (Failed(hr))
         throw new ComException(hr);
      ICalendar calendar;
      hr = instance.QueryInterface(IID_ICalendar, out calendar);
      if (Failed(hr))
         throw new ComException(hr);

      this._calendar = calendar;
   }
}

现在您可以使用友好的类似 C# 的投影：

Calendar cal = new Calendar();

Pascal 版本的构造函数

假设您正在使用 Delphi：您已经有一个用于创建对象的习惯用法。让我们将底层管道转换为友好的 Pascal 投影：

TCalendar = class
private
   FCalendar: ICalendar;
public
   constructor Create;
end;

constructor TCalendar.Create;
var
   instance: IInspectable;
   calendar: ICalendar;
   hr: HRESULT;
begin
   inherited Create;

   hr := RoActivateInstance(StringToHSTRING('Windows.Globalization.Calendar'), {out} instance);
   OleCheck(hr);

   hr = instance.QueryInterface(IID_ICalendar, {out} calendar);
   OleCheck(hr);

   FCalendar := calendar;
end;

现在我们有了Delphi 投影：

calendar: TCalendar;

calendar := TCalendar.Create;

属性（如果你得到了就使用它们）

在底层ICalendar接口中，您必须使用方法获取和设置属性：

  • get_Year
  • set_Year

如果你盲目地将它翻译成 C#，你会得到：

C#属性方法：

class Calendar : Object
{
   private ICalendar _calendar;

   public int get_Year() { return _calendar.get_Year(); }
   void set_Year(int value) { _calendar.set_Year(value); }
}

Pascal属性方法：

TCalendar = class
public
   function get_Year: Integer;
   procedure set_Year(Value: Integer);
end;

但是，如果您的语言支持它们，您实际上应该将这些属性公开为实际的"Properties"。所以我们可以使用我们语言原生的属性语法来投影这些属性：

C#：

class Calendar : Object
{
   private ICalendar _calendar;

   public int Year { 
         get { return _calendar.get_Year(); } 
         set { _calendar.set_Year(value); }
   }
}

帕斯卡：

TCalendar = class
public
   property Year: Integer read get_Year write set_Year;
end;

迭代器

这个想法是创建一个外观和感觉都像您的语言的外观，但在幕后它映射回底层调用。它走得很深。

在 WinRT 中，所有可枚举的实现

  • IIterable<T>

但是在 C# 中，所有可枚举的东西都应该从以下开始：

  • IEnumerable

所以 .NET 库有一个内部类，它适应一个IIterable<T>并将其公开为一个IEnumerable.

因此，而不是返回一个方法IIterable<T>：

class Calendar : Object
{
   public IIterable<Datetime> Holidays()
   {
      return _calendar.Holidays();
   }
}

它返回一个IEnumerable<T>：

class Calendar : Object
{
   public IEnumerable<DateTime> Holidays()
   {
       IIterable<DateTime> iter = _calendar.Holidays();

       //Create helper class to convert IIterable to IEnumerable
       IEnumerable<DateTime> enum = new IteratorToEnumeratorAdapter(iter);

       return enum;
   }
}

这样你就可以使用你自己的语言：

  • foreach date in Holidays
  • for date in Holdays do

日期是什么？

在 WinRT 中，日期表示为Windows.Foundation.DateTime：

class Calendar : Object
{
   //Windows.Foundation.DateTime
   Datetime Date { get { return _calendar.get_Date(); } set { _calendar.set_Date(value); }
}

但在其他语言中，我们已经有了自己的日期时间类：

  • C#：System.DateTimeOffset
  • Javascript：Date
  • C++：FILETIME
  • 德尔福：TDateTime

因此，投影完成了将 WinRT DateTime（自 1601 年 1 月 1 日以来的 100ns 间隔数的 Int64）转换为 C# 的工作DateTimeOffset：

class Calendar : Object
{
   //System.DateTimeOffset
   DateTimeOffset Date { 
       get { 
          Int64 ticks _calendar.get_Date().UniversalTime(); 
          DateTimeOffset dt = DateTimeOffset.FromFileTime(ticks);
          return dt;
       } 
       set { 
          Int64 ticks = value.ToFileTime();

          DateTime dt = new Windows.Foundation.DateTime();
          dt.UniversalTime = ticks;
          _calendar.set_Date(dt);
       }
}

和类似于德尔福的TDateTime的东西：

type
   TCalendar = class(TObject)
   private
      FCalendar: ICalendar;
      function getDate: TDateTime;
      procedure setDate(Value: TDateTime);
   public
      property Date: TDateTime read getDate write setDate;
   end;

   function TCalendar.GetDate: TDateTime;
   var
      ticks: Int64;
   const
      OA_ZERO_TICKS = Int64(94353120000000000);
      TICKS_PER_DAY = Int64(864000000000);
   begin
      ticks := FCalendar.get_Date().UniversalTime;
      Result := (ticks - OA_ZERO_TICKS) / TICKS_PER_DAY;
   end;

   procedure TCalendar.SetDate(Value: TDateTime);
   var
      ticks: Int64;
   const
      OA_ZERO_TICKS = Int64(94353120000000000);
      TICKS_PER_DAY = Int64(864000000000);
   begin
      ticks := (Value * TICKS_PER_DAY) + OA_ZERO_TICKS;
      FCalendar.set_Date(Round(ticks));
   end;

tl;博士

投影是 WinRT 周围的一组包装器，使其看起来尽可能像您的母语。

在 C# 中，实际上没有人编写计划版本；编译器和运行时在幕后完成所有工作，因为它知道如何读取元数据。

对于其他语言，翻译后的代码文件可以手动创建，也可以通过导入工具自动创建。

于 2019-02-22T19:26:13.427 回答
4

最简单的澄清方法是 WinRT 中的语言投影是“前端”，而 Windows 运行时是后端。从三种语言（JS、C#、VB）中的一种编写，它在后端的行为相同。

如果您使用 C++ 或 C# 编写自己的 3rd Party WinRT 组件，则可以在 JS、C# 和 VB 中使用它，而无需做任何额外的工作。

于 2011-09-15T21:36:35.733 回答