win8开发（10）——如何共享文本内容

首先请各位看下面的图。

 
 

相信微博的这个功能，大家不陌生吧。那么它是怎么实现的呢？

首先，我们要了解一个东西，应用程序协定，名称不好理解，也很难翻译，这样吧，我们看看它是

在哪里设置的，也许你会有点感悟。

用VS2012新建windows store应用后，你会看到项目中有个清单文件，用于配置与应用程序包相关

的信息。

[attach]223    [/attach]


双击打开它。
切换到“声明”选项卡

[attach]    220[/attach]

这就是应用程序协定，你可以理解为为你的应用程序声明多种启动方式，并作为特定的目标使用

，如上面图片中，新浪微博为什么可以在其它应用程序中启动，并且可以共享信息，这样，我们可以理解为应用程序之间数据的传递，而我们最常见的一种方式就是复制-粘贴，这是利用剪贴板作为载体实现应用程序之间 的数居共享。

如果还是觉得很抽象，那最好的办法就是用实例来说明，我们来模拟刚才新浪微博的功能，一个

解决方案我们需要建两个项目，一个是共享源，即发送共享数据的一方；另一个是共享目标，即接受共享数据的一方。

首先我们来实现共享源，即发送方。
1、启动VS，新建项目。
2、在MainPage.xaml中输入以下XAML代码。
     <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
        <StackPanel>
            <TextBox Name="txtContent" Height="285"/>
            <Button Margin="12,15,0,0" Content="共享" Click="onShare"/>
        </StackPanel>
    </Grid>

3、然后，我们要处理按钮的Click事件。
        private void onShare(object sender, RoutedEventArgs e)
        {
            DataTransferManager.ShowShareUI();
        }

ShowShareUI方法是静态的，可以直接调用，DataTransferManager位于命名空间

Windows.ApplicationModel.DataTransfer，发送共享数据正是通过它来完成。

那，什么时候设置我们要发送的数据呢？例如，现在我要共享目标共享一条文本信息，

设置数据是在DataTransferManager类的DataRequested事件中处理的。

通过GetForCurrentView方法获得DataTransferManager的实例，故在MainPage类

的构造函数加入以下代码。

        public MainPage()
        {
            this.InitializeComponent();
            DataTransferManager.GetForCurrentView().DataRequested += MainPage_DataRequested;
        }
4、处理DataRequested事件。
        void MainPage_DataRequested(DataTransferManager sender, DataRequestedEventArgs args)
        {
            var defl = args.Request.GetDeferral();
            // 设置数据包
            DataPackage dp = new DataPackage();
            dp.Properties.Title = "共享文本";
            dp.Properties.Description = "分享一些字符串。";
            dp.SetText(txtContent.Text);
            args.Request.Data = dp;
            // 报告操作完成
            defl.Complete();
        }

OK，现在我要完成共享目标。

在解决方案资源管理器”解决方案节点上右击，在弹出菜单中依次选择“添加”->“新建项目”

，再建一个App，它就是数据的接收方。

1、打开清单文件，切换到“声明”选项卡，在下拉列表中选择“共享目标”，并单击

“添加”按钮。

 

在右面的面板中，找到“数据格式”节，单击“新增”按钮。

 

因为只需传递文本信息，因此，输入 Text 即可。

 

保存，关闭清单文件。

2、新建一个空白页，命名为SharedPage.xaml，XAML代码如下。
    <Grid Background="#FF0B4C81">
        <TextBlock Margin="10,15,0,0"
                   FontSize="28"
                   VerticalAlignment="Top"
                   HorizontalAlignment="Left"
                   x:Name="tbShareText"/>
    </Grid>


3、打开SharedPage.xaml.cs
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Windows.ApplicationModel.Core;
// “空白页”项模板在 http://go.microsoft.com/fwlink/?LinkId=234238 上有介绍
namespace ShareTargetSample
{
    /// <summary>
    /// 可用于自身或导航至 Frame 内部的空白页。
    /// </summary>
    public sealed partial class SharedPage : Page
    {
        public SharedPage()
        {
            this.InitializeComponent();
        }
        /// <summary>
        /// 在此页将要在 Frame 中显示时进行调用。
        /// </summary>
        /// <param name="e">描述如何访问此页的事件数据。Parameter
        /// 属性通常用于配置页。</param>
        protected override void OnNavigatedTo(NavigationEventArgs e)
        {
            if (CoreApplication.Properties.ContainsKey("value"))
            {
                this.tbShareText.Text = CoreApplication.Properties["value"].ToString();
            }
        }
    }
}

我们并不是在该页面上取共享数据，该页只是负责显示。我们取得的共享数据保存在

CoreApplication.Properties集合中，该页面便从该集合中取得数据并显示。

4、打开App.xaml.cs

我们在App类中重写OnShareTargetActivated方法，如果应用程序由用户启动，

则调用OnLaunched方法，但如果是共享源调用导致应用程序启动，则调用

OnShareTargetActivated方法，这就是应用程序协定的作用。

        protected async override void OnShareTargetActivated(ShareTargetActivatedEventArgs args)
        {
            var opr = args.ShareOperation;
            // 开始取数据
            opr.ReportStarted();
            DataPackageView pv = opr.Data;
            if (pv.Contains(StandardDataFormats.Text))
            {
                CoreApplication.Properties["value"] = await pv.GetTextAsync();
            }
            opr.ReportDataRetrieved();
            Frame root = Window.Current.Content as Frame;
            if (root == null)
            {
                root = new Frame();
                root.Navigate(typeof(SharedPage));
            }
            Window.Current.Content = root;
            Window.Current.Activate();
            //opr.ReportCompleted();
            //opr.ReportError("无法共享。");
        }

好的，完成，但是，我们必须以正常启动运行一次共享目标程序，不然，它不会安装到

系统的应用列表中。在解决方案资源管理器中，选中共享目标项目，右击，选择“调试”-“启动新实例”。

待程序运行后，再把它结束，这时候，打开电脑设置（鼠标移到右上角或右

下角，从出现的侧边栏中点击“设置”，点击下方的“更多电脑设置”），选择“共享”，

这时我们看到，共享目标的共享功能已经打开。

这时我们看到，共享目标的共享功能已经打开。
 

现在，运行共享源项目，在页面上随便输入一些内容。点击共享按钮。

 

然后点击我们的应用程序，

 


这样，我们的共享目标示例程就接收到共享数据了。

还没完，大家可能注意，上面App.xaml.cs中，有两行代码我故意注释掉了，

现在我们看看分别取消这两行代码，会发生什么。

1、取消第一行
            opr.ReportCompleted();
            //opr.ReportError("无法共享。");

然后，按上面的方法运行，我们发现，共享目标一收到数据就退出了，对的，在共享目标中，

我们对接收的共享数据进行处理，处理完后，一旦调用ShareOperation的ReportCompleted

方法报告共享操作完成，那么共享目标程序就会自动退出。 

同样道理，注释掉第一行，取消第二行的注释，我们让它共享失败。
//opr.ReportCompleted();
            opr.ReportError("无法共享。");
记住，现在要以正常启动方式运行一次共享目标程序，因为这样做，新的修改才会生效。
 

报告错误后，就会收到上面的提示。