![\"Веб-интерфейс](\"https://blog.zwezdin.com/2017/asp-net-core-logging-into-kibana/a61527e6/kibana@2x.png\")
Если над проектом работает команда из нескольких человек, то она неизбежно сталкивается с проблемой стиля кодирования. Кто-то скобки расставил по-своему, кому-то больше нравится var вместо указания явного типа, кому-то — наоборот. Чего уж там говорить про open-source проекты, где случайный прохожий может сделать баг-фикс и уйти. Всё это ведет к тому, что стиль кода в проекте сильно разнится в разных его частях.
EditorConfig — это проект, который помогает разработчикам соблюдать единый стиль кода в рамках всего проекта. Visual Studio 2017 — одна из множества сред разработки, которая имеет встроенную поддержку EditorConfig.
\nПроект EditorConfig можно разделить на две части — формат файла, описывающий правила оформления кода и плагины для среды разработки, которые помогают эти правила соблюдать.
\nПрактически все современные среды разработки имеют либо встроенные средства для поддержки EditorConfig, либо поддерживают EditorConfig за счёт устанавливаемых плагинов:
\n\n\n\n![\"EditorConfig](\"https://blog.zwezdin.com/2017/vs-2017-editorconfig/835b3fa4/ides@2x.png\")
\n\n\n\n\nЧтобы добавить правила для стиля кода, достаточно положить файл .editorconfig в корневую папку вашего проекта. При этом можно изменять эти правила в отдельных подпапках — для этого создаем дополнительный файл .editorconfig в нужной подпапке. Т.е. правила EditorConfig применяются иерархически.
Формат файла .editorconfig напоминает INI-файлы с немного расширванным синтаксисом.
Для корневого файла .editorconfig в самом начале нужно добавить root = true. Символы # и ; позволяют добавить комментарии в файл. Превоначальная заготовка выглядит так:
# Правила EditorConfig для\n# описания стиля кодирования\n\nroot = trueДалее следует описание правил. Но перед этим необходимо определить типы файлов, к которым эти правила должны применяться. Типы файлов задаются в стиле INI-секции:
\nroot = true\n\n[*]\nindent_style = space\nindent_size = 2\n\n[*.cs]\nindent_size = 4Как видно, правила для всех файлов задаются в секции [*].
Указать типы файлов можно при помощи специальных шаблонов, при написании которых действуют следующие правила:
\n* — означает множество любых символов, кроме /** — означает множество любых символов, включая /? — означает любой единственный символ[name] — явно задает имя файла[!name] — применяется ко всем файлам, кроме указанного{s1,s2,s3} — применяется ко всем файлам, указанным в списке{x..y} — позволяет задать целочисленный диапазонВот некоторые примеры описания типа файлов:
\n[*.cs] — все файлы с расширением cs[*.{cs,vb}] — все файлы с расширением cs и vb[Properties/AssemblyInfo.cs] — файл AssemblyInfo.cs из папки Properties[Model/**.js] — все файлы .js из папки Model, включая подпапки[{appsettings.json, appsettings.dev.json, appsettings.test.json}] — файлы из спискаДля каждой секции нужно задать правила. Правила зависят от того, для какого языка программирования вы их пишете.
\nПравила задаются в следующем формате:
\n\n\n\n
<имя правила>=<значение>
Для C# также можно задавать степень важности правила:
\n\n\n
<имя правила>=<значение>:<важность правила>
Задание уровня важности правила позволяет повлиять на поведение компилятора и среды разработки при нарушении правила. Уровень важности может принимать следующие значения:
\nnone — нет никакой реакции, если правило было нарушено.suggestion — при нарушении правила в момент сборки проекта появляется рекомендация во вкладке Messages в Error List.warning — при нарушении правила в момент сборки проекта появляется ошибка во вкладке Warnings в Error List. В этом случае сборка останавливается, если установлена опция Treat Warnings as Errors.error — при нарушении правила в момент сборки проекта появляется ошибка во вкладке Errors в Error List и сборка останавливается.Например, для правила:
\n[*.cs]\ncsharp_style_var_for_built_in_types = false:warningМы увидим только предупреждение в момент сборки, если правило было нарушено.
\nНо если правило изменить так:
\n[*.cs]\ncsharp_style_var_for_built_in_types = false:errorТо вы не сможете собрать проект, пока ошибка не будет исправлена.
\nСписок наиболее популярных правил можно найти здесь. Для .NET список правил здесь. В качестве примера .editorconfig для .NET можно посмотреть файл команды Roslyn.
Создадим правила для проекта .NET:
\nroot = true\n\n[*]\n# Использовать отсутпы для пробелов\nindent_style = space\n\n# Использовать 4 пробела для отступа\nindent_size = 4\n\n# Использовать UTF-8 для всех файлов\ncharset = utf-8\n\n# Запретить пробелы в конце строки\ntrim_trailing_whitespace = false\n\n# Запретить пустую строку в конце файла\ninsert_final_newline = false\n\n[*.cs]\n# Использовать явное указание простых типов\ncsharp_style_var_for_built_in_types = false:warning\n\n# Использовать var когда тип очевиден исходя\n# из правой части выражения\ncsharp_style_var_when_type_is_apparent = true:warning\n\n# Во всех остальный случаях также использовать var\ncsharp_style_var_elsewhere = true:warning\n\n# Новая строка перед открывающей скобкой\ncsharp_new_line_before_open_brace = true:error\n\n# Новая строка перед членами в анонимных типах\ncsharp_new_line_before_members_in_anonymous_types = true:warningЕсли в .editorconfig не указано какое-либо из правил, то считается, что нужно использовать текущие настройки среды разработки.
Visual Studio 2017 имеет встроенную поддержку EditorConfig, т.е. вы просто можете добавить файл .editorconfig в проект и пользоваться этим инструментом. Для более ранних версий Visual Studio можно воспользоваться расширением EditorConfig.
\n\nВажно! Настройки
\n.editorconfigимеют приоритет над настройками среды разработки.
Это означает, что если у вас в Visual Studio, например, установлен отступ в 4 символа, а в.editorconfig— два, то среда разработки будет считать, что актуальная настройка — два символа.
При подключении .editorconfig к проекту Visual Studio автоматически подхватит эти настройки. Теперь если вы отформатируете документ при помощи меню Edit → Advanced → Format Document или Ctrl + e, D, то документ будет отформатирован в соответствии с правилами .editorconfig:
Если при сборке проекта какое-то правило нарушено, то вы увидите об этом ошибку:
", "tags": [ "C#", ".NET", "Visual Studio" ], "banner_image": "https://blog.zwezdin.com/2017/vs-2017-editorconfig/c34cda2a/vs_2017-editorconfig@cover.png" }, { "id": "https://blog.zwezdin.com/2017/asp-net-core-logging-into-kibana/", "url": "https://blog.zwezdin.com/2017/asp-net-core-logging-into-kibana/", "title": "Подключаем Kibana для хранения логов ASP.NET Core", "date_published": "2017-03-19T06:00:00.000Z", "content_html": "Логи — полезные инструмент для отладки и мониторинга приложений. Только просмотр текстовых логов — дело скучное и неинтересное. Поэтому изучают логи в исключительных ситуациях. Здесь на помощь приходят структурированные логи — когда записи хранятся не просто в виде текста, а в виде структурированных данных с разделением информации на отдельные поля. По таким логам можно настроить фильтры, поиск, при соблюдении определенных условий — отправлять уведомления и т.д.
\nИнфраструктура логгирования ASP.NET Core поддерживает структурированные логи. Посмотрим как это можно использовать на примере ELK.
\nОдин из вариантов хранения структурированных логов — хранение их в Elasticsearch. Преимущество этого подхода заключается в том, что для этого всё уже готово — вам не нужно допиливать код для хранения данных.
\nELK — это стек из трех продуктов: Elasticsearch, Logstash и Kibana:
\nЧтобы попробовать ELK можно использовать Docker-образ sebp/elk:
\ndocker pull sebp/elk\ndocker run -p 5601:5601 -p 9200:9200 -p 5044:5044 -it --name elk sebp/elkПодробнее о том, как запустить ELK внутри Docker можно почитать в документации.
\nПосле запуска Kibana будет доступна через порт 5601, а Elasticsearch API — через 9200.
Для реального проекта Elasticsearch весьма требователен к оборудванию (в частности - к RAM). Поэтому хорошим вариантом может быть использование ELK как сервиса. К счастью, таких сервисов очень много, например — раз, два, три.
\nЕсли для отправки данных используется Logstash, то всё сводится к записи логов в файл и настройки Logstash для чтения этих файлов и отправки в Elasticsearch. Альтернативным способом может быть отправка данных напрямую в Elasticsearch, минуя Logstash. Рассмотрим этот способ.
\nСтоит отметить, что в данном случае нам потребуется какая-нибудь библиотека для работы с Elasticsearch. Желательно также, чтобы эта библиотека была интегрирована с инфраструктурой логгирования ASP.NET Core. С учетом этого, Serilog может быть хорошим выбором: она интегрирована с ASP.NET Core и имеет провайдер для отправки логов в Elastisearch.
\nУстановим в проект пакет Serilog, а заодно Serilog.Extensions.Logging и Serilog.Sinks.Elasticsearch.
Теперь необходимо добавить Serilog-логгер в DI-контейнер:
\npublic class Startup\n{\n public void ConfigureServices(IServiceCollection services)\n {\n services.AddSingleton<Serilog.Core.Logger>(container => new LoggerConfiguration()\n .ConfigureEnrichers(container)\n .ConfigureElk(\"http://elk:9200\", Configuration.GetSection(\"Logging:Elk\"), container)\n .ConfigureSelfLog(container)\n .CreateLogger());\n }И в список логгинг-провайдеров:
\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory.AddSerilog(services.GetService<Serilog.Core.Logger>());\n }\n}Обратите внимание, что при конфигурировании ELK указана конфигурационная секция Logging:Elk. В ней мы указываем параметры фильтров, о которых я писал ранее.
Для данного примера конфигурационный файл может выглядеть так:
\n{\n \"Logging\": {\n \"Console\": {\n \"IncludeScopes\": false,\n \"LogLevel\": {\n \"Default\": \"Debug\",\n \"System\": \"Information\",\n \"Microsoft\": \"Information\"\n }\n },\n \"Elk\": {\n \"IncludeScopes\": false,\n \"LogLevel\": {\n \"MyApp.Services\": \"Information\",\n \"MyApp.Infrastructure\": \"Information\"\n }\n }\n }\n}Теперь можно воспользоваться стандартным API для логгирования и создавать записи в в ELK:
\npublic class HomeController : Controller\n{\n private readonly ILogger _logger;\n\n public HomeController(ILogger<HomeController> logger)\n {\n _logger = logger;\n }\n\n public IActionResult Index()\n {\n _logger.LogError(\"Some error occured\");\n return View();\n }\n}Однако, гораздо интереснее в таком случае писать в лог структурированную информацию. Для этого немного изменим способ логгирования:
\npublic class HomeController : Controller\n{\n private readonly ILogger _logger;\n\n public HomeController(ILogger<HomeController> logger)\n {\n _logger = logger;\n }\n\n public IActionResult Index()\n {\n var request = ...;\n var config = ...;\n _logger.LogError(\"Some error occured.{User}{@Request}{@Config}\",\n User.Identity.Name, request, config);\n return View();\n }\n}Теперь данные отправляются в ELK в структурированном виде.
\nЕсли для каждой записи в лог требуется сохранять какие-то стандартные данные (например, данные HTTP-запроса, окружения и т.д.) можно воспользоваться специальными объектами Serilog — Enricher‘ами. О том, как их использовать можно почитать в документации.
ASP.NET Core предоставляет удобную абстракцию для ведения логов. Благодаря этому работа с логами устроена одинаково, независимо от того, какой провайдер используется в приложении.
\nПровайдеры в свою очередь обеспечивают инфраструктуру для хранения логов в том или ином хранилище. Базовые библиотеки уже имеют набор стандартных провайдеров для наиболее популярных хранилищ. Но что если требуется отправлять логи в собственное, нестандартное хранилище? Для этого можно реализовать собственный провайдер.
\nПредположим на требуется отправлять информацию об ошибках из лога при помощи SMS через сторонний сервис.
\nДля начала нам требуется реализовать логгер. Логгер — это объект, который непосредственно реализует логику сохранения в конкретный тип хранилища. Он в курсе всех деталей и тонкостей именно этого хранилища.
\nДля реализации собственного логгера, следует создать объект, реализующий интерфейс ILogger. Этот интерфейс имеет три метода:
BeginScope() — позволяет определить группу сообщений. Если логгер поддерживает scope, то здесь следует вернуть IDisposable.IsEnabled() — возвращает информацию о том, доступен ли данный логгер для заданного уровня логгирования.Log() — метод, непосредственно реализующий логику сохранения записи в лог.Первая реализация логгера может выглядеть так:
\npublic class SmsLogger : ILogger\n{\n public SmsLogger()\n {\n }\n\n public IDisposable BeginScope<TState>(TState state)\n {\n return null;\n }\n\n public bool IsEnabled(LogLevel logLevel)\n {\n return true;\n }\n\n public void Log<TState>(LogLevel logLevel, EventId eventId,\n TState state, Exception exception, Func<TState, Exception, string> formatter)\n {\n if (IsEnabled(logLevel))\n {\n var msg = formatter(state, exception);\n\n // send sms here\n }\n }\n}В этой реализации отсутствует фильтрация, поэтому IsEnabled() всегда возвращает true. Также отправка SMS не поддерживает scope, поэтому BeginScope() возвращает null.
Внутри метода Log() следует обратиться к внешнему сервису для отправки сообщения. Здесь можно использовать любой сторонний сервис и просто отправлять ему HTTP-запрос всякий раз, когда требуется логгирование.
Чтобы подключить логгер к приложению требуется провайдер. Провайдер — это объект, который при необходимости создает логгер. Также провайдер занимается освобождением ресурсов. Для реализации провайдера нужно создать объект, реализующий интерфейс ILoggerProvider:
public class SmsLoggerProvider : ILoggerProvider\n{\n public SmsLoggerProvider()\n {\n }\n\n public ILogger CreateLogger(string category)\n {\n return new SmsLogger();\n }\n\n public void Dispose()\n {\n }\n}Теперь чтобы подключить провайдер к приложению, достаточно добавить этот провайдер в коллекцию провайдеров:
\npublic class Startup\n{\n public void ConfigureServices(IServiceCollection services)\n {\n }\n\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory.AddProvider(new SmsLoggerProvider());\n }\n}Можно добавить немного синтаксического сахара и сделать метод-расширение для добавления провайдера:
\npublic static class SmsLoggerProviderExtensions\n{\n public static ILoggerFactory AddSms(this ILoggerFactory loggerFactory)\n {\n loggerFactory?.AddProvider(new SmsLoggerProvider());\n return loggerFactory;\n }\n}Тогда код добавления провайдера можно переписать следующим образом:
\npublic class Startup\n{\n public void ConfigureServices(IServiceCollection services)\n {\n }\n\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory.AddSms();\n }\n}Фильтры позволяют настроить какие именно записи будут попадать в лог для данного провайдера. Для нашего примера это особенно актуально — было бы глупо отправлять через SMS информацию о всех HTTP-запросах. Поэтому давайте добавим поддержку фильтров для нашего провайдера.
\nВ первую очередь добавим поддержку фильтров в реализацию логгера:
\npublic class SmsLogger : ILogger\n{\n private readonly string _category;\n\n private readonly Func<string, LogLevel, bool> _filter;\n\n public SmsLogger(string category, Func<string, LogLevel, bool> filter)\n {\n _category = category;\n _filter = filter;\n }\n\n public IDisposable BeginScope<TState>(TState state)\n {\n return null;\n }\n\n public bool IsEnabled(LogLevel logLevel)\n {\n return _filter == null || _filter(_category, logLevel);\n }\n\n public void Log<TState>(LogLevel logLevel, EventId eventId,\n TState state, Exception exception, Func<TState, Exception, string> formatter)\n {\n if (IsEnabled(logLevel))\n {\n var msg = formatter(state, exception);\n // send sms here\n }\n }\n}Как видно, код поменялся не очень существенно: конструктор теперь получает информацию о категории и функцию-фильтр. Эти данные используются в методе IsEnabled().
Для задания фильтра немного изменим реализацию провайдера:
\npublic class SmsLoggerProvider : ILoggerProvider\n{\n private readonly Func<string, LogLevel, bool> _filter;\n\n public SmsLoggerProvider(Func<string, LogLevel, bool> filter)\n {\n _filter = filter;\n }\n\n public ILogger CreateLogger(string category)\n {\n return new SmsLogger(category, _filter);\n }\n\n public void Dispose()\n {\n }\n}И метода-расшрения для подключения провайдера:
\npublic static class SmsLoggerProviderExtensions\n{\n public static ILoggerFactory AddSms(this ILoggerFactory loggerFactory,\n Func<string, LogLevel, bool> filter = null)\n {\n loggerFactory?.AddProvider(new SmsLoggerProvider(filter));\n return loggerFactory;\n }\n}Теперь при добавлении провайдера можно явно указать как именно нужно фильтровать сообщения, отправляемые через SMS:
\npublic class Startup\n{\n public void ConfigureServices(IServiceCollection services)\n {\n }\n\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory.AddSms((category, level) =>\n {\n if (category.Contains(\"MyApp\") && level == LogLevel.Critical)\n return true;\n\n return false;\n });\n }\n}Поскольку логгирование является неотъемлемой частью любого приложения, в ASP.NET Core появилась унифицированная инфраструктура для логгирования.
\nЕдиный интерфейс для записи в лог позволяет приложениям работать с логом в едином стиле, независимо от того, какой провайдер используется.
\nПрежде чем начать писать что-то в логи, нужно настроить провайдеров логов. Для этого в метод Configure() класса Startup инжектируется сервис ILoggerFactory. Используя этот сервис можно настроить провайдеров:
public class Startup\n{\n public void ConfigureServices(IServiceCollection services)\n {\n }\n\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory.AddDebug();\n\n // ...\n }\n}В данном примере добавялется провайдер, который будет писать логи в консоль отладчика. Чтобы добавить этого провайдера, нужно установить пакет Microsoft.Extensions.Logging.Debug. Впрочем, он уже итак установлен в проекте, который создается в базовом шаблоне проекта ASP.NET MVC.
Аналогичным образом добавляются и другие провайдеры. Microsoft предоставляет такие провайдеры как Microsoft.Extensions.Logging.Console, Microsoft.Extensions.Logging.Debug, Microsoft.Extensions.Logging.TraceSource, Microsoft.Extensions.Logging.AzureAppServices, Microsoft.Extensions.Logging.EventSource, Microsoft.Extensions.Logging.EventLog. Как нетрудно догадаться из названия, каждый из них имеет собственный источник для хранения логов.
Можно использовать несколько провайдеров одновременно:
\npublic class Startup\n{\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory.AddDebug();\n loggerFactory.AddConsole();\n\n // ...\n }\n}Для того, чтобы начать писать что-то в лог, следует инжектировать интерфейс ILogger в нужный компонент приложения. Причем в качестве generic-параметра мы можем указать категорию логгера. Например, получим доступ к логгеру в компоненте HomeController:
public class HomeController : Controller\n{\n private readonly ILogger _logger;\n\n public HomeController(ILogger<HomeController> logger)\n {\n _logger = logger;\n }После этого в рамках компонента можно пользоваться этим логгером и добавлять записи в лог. Для записи используются методы, соответствующие уровню важности сообщения:
\nLogDebug()LogTrace()LogInformation()LogWarning()LogError()LogCritical()Попробуем записать что-нибудь в лог:
\npublic IActionResult Index()\n{\n _logger.LogError(\"Some error occured\");\n return View();\n}Теперь при срабатывании этого действия в консоли отладчика обязательно появится запись:
\n\n\nWebApplication8.Controllers.HomeController:Error: Some error occured
\n
Если при настройке провайдеров мы настроили также вывод в консоль (AddConsole()), то эта же запись появится и в консоли (если мы запускаем приложение через Kestrel и консоль нам видна).
![\"Логгирование](\"https://blog.zwezdin.com/2017/asp-net-core-logging/2ae0d79f/console-logger@2x.png\")
\n\n\n\n\nЗаписывать в лог можно не только обычные строки, но и структурированные данные. Для этого существуют специальные перегрузки методов LogXXX(). Запишем, например, в лог данные с идентификатором объекта:
public IActionResult Index()\n{\n _logger.LogError(\"Unable to delete object with {ID} key\", 25);\n return View();\n}В логе появится строка следующего содержания:
\n\n\nWebApplication8.Controllers.HomeController:Error: Unable to delete object with 25 key
\n
Если провайдер поддерживает структурированные данные, то ID будет доступно как отдельное поле. Более того, поле может быть не только простым типом, но и составным объектом. Но это — отдельная тема и здесь касаться этого не будем.
Иногда бывает полезно объединить набор сообщений лога в группы. Это можно сделать используя метод BeginScope(), реализующий IDisposable. Поэтому можно использовать конструкцию using для группировки сообщений в логе:
public IActionResult Index()\n{\n using (_logger.BeginScope(\"Updating object {ID}\", 25))\n {\n _logger.LogInformation(\"Checking object state\");\n\n // ...\n\n _logger.LogInformation(\"Updating object reference\");\n\n // ...\n\n _logger.LogError(\"Something went wrong\");\n }\n\n return View();\n}Не все провайдеры поддерживают такую группировку. Однако, те, кто поддерживают будут иметь пометку Updating object {ID} для каждой записи внутри scope.
Например, группировку поддерживает Microsoft.Extensions.Logging.Console. Для её использования это нужно указать явно при настройке провайдера:
public class Startup\n{\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory.AddConsole(includeScopes: true);\n\n // ...\n }\n}В таком случае для каждого сообщения внутри scope будет добавлена строка Updating object {ID}:
![\"Логгирование](\"https://blog.zwezdin.com/2017/asp-net-core-logging/29d3e723/logging-scope@2x.png\")
\n\n\n\n\nВ логи обычно записывается большой объем отладочной информации. Например, инфраструктура ASP.NET записывает туда информацию о каждом обработанном HTTP-запросе. Это может быть полезно во время отладки, но когда приложение работает на боевом сервере, эта информация не нужна. Более того, в большом потоке отладочной информации можно не увидеть действительно ценного — сообщения об ошибках или каких-либо нестандартных ситуациях. Поэтому для разных окружений настройки логгирования можно настроить по-разному.
\nВсе записи в логах разделяются по степени важности. Например, методы LogDebug() и LogInformation() записывают событие с какими-то отладочными данными. Их смысл в том, чтобы дать представление о процессах, которые происходят в приложении, но не более. С другой стороны LogWarning(), говорит о том, что в приложении произошло что-то, на что было бы неплохо обратить внимание. Наконец, LogError() или LogCritical() записывает информацию об ошибках — т.е. приложение повело себя не так, как планировалось, и на такие записи обязательно нужно обращать внимание.
В ASP.NET Core можно задать минимальный уровень для фильтрации логов. Например, при отладке можно разрешить показывать все сообщения, включая Trace, Debug и Information. При этом на боевом сервере эти сообщения можно зафильтровать и отображать только ошибки.
Это поведение задается при помощи специального параметра:
\npublic class Startup\n{\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory.AddDebug(minLevel: LogLevel.Error);\n loggerFactory.AddConsole(minLevel: LogLevel.Warning);\n\n // ...\n }\n}В этом случае всё, что менее критично, чем Error или Warning будет игнорироваться для этих провайдеров.
Но не все категории записей в логе одинаково полезны. Например, в каких-то ситуациях нам могут быть неинтересны ошибки, которые пишутся в лог инфраструктурой ASP.NET, даже если для них задан уровень Error, но при этом очень важны записи, сделанные нашими собственными сервисами, причем для менее приоритетных уровней.
Именно для этого и существует generic-параметр интерфейса ILogger<T>. Параметр задает категорию сообщений, которую можно использовать для фильтрации сообщений. В этом случае настройки могут отличаться от провайдера к провайдеру. Но общие принципы таковы, что для отдельных категорий сообщений мы указываем собственный уровень логгирования.
Вот как например можно настроить провайдер для записи в консоль:
\npublic class Startup\n{\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory.AddConsole((category, level) =>\n {\n if (category.Contains(\"MyApp\") && level >= LogLevel.Information)\n return true;\n else if (category.Contains(\"Microsoft\") && level >= LogLevel.Error)\n return true;\n\n return false;\n });\n\n // ...\n }\n}Другой способ — использовать конфигурационный файл для настройки уровней логгирования:
\npublic class Startup\n{\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory.AddConsole(Configuration.GetSection(\"Logging\"));\n\n // ...\n }\n}Конфигурационный файл в этом случае может выглядеть так:
\n{\n \"Logging\": {\n \"IncludeScopes\": false,\n \"LogLevel\": {\n \"Default\": \"Warning\",\n \"Microsoft\": \"Error\",\n \"MyApp\": \"Information\"\n }\n }\n}Ещё один удобный способ настроить фильтры — это использовать пакет Microsoft.Extensions.Logging.Filter. После установки этого пакета для ILoggerFactory, появится метод-расширение WithFilter(), позволяющий настроить фильтры:
public class Startup\n{\n public void Configure(IApplicationBuilder app, IHostingEnvironment env,\n ILoggerFactory loggerFactory)\n {\n loggerFactory\n .WithFilter(new FilterLoggerSettings\n {\n { \"Microsoft\", LogLevel.Error },\n { \"MyApp\", LogLevel.Information }\n })\n .AddConsole()\n .AddDebug();\n\n // ...\n }\n}Такой способ удобен, когда нужно настроить фильтр одновременно для нескольких провайдеров. Также он позволяет задавать фильтры единым способом, даже когда провайдер не имеет параметров для настройки фильтров.
\nДобавленный в ASP.NET Core встроенный мехнизм логгрования отлично интегрируется с большиством известных фреймворков. Если вы уже используете в приложение какой-то существующий фреймворк — не нужно удалять его из проекта. Скорее всего для него уже создан провайдер для интеграции с ASP.NET Core. Вот провайдеры для некоторых популярных фреймворков:
\n", "tags": [ "ASP.NET", ".NET Core", "Logging" ], "banner_image": "https://blog.zwezdin.com/2017/asp-net-core-logging/a8f6fea7/asp_net-core-logging@cover.jpg" }, { "id": "https://blog.zwezdin.com/2017/mindstorms-ev3-net-api/", "url": "https://blog.zwezdin.com/2017/mindstorms-ev3-net-api/", "title": "Работаем с Lego Mindstorms EV3 из .NET", "date_published": "2017-03-05T13:35:00.000Z", "content_html": "Традиционно роботы, построенные на платформе Lego Mindstorms EV3, программируются с использованием графической среды LabVIEW. В этом случае программы запускаются на контроллере EV3 и робот работает автономно. Здесь я расскажу про альтернативный способ управления роботом — использование платформы .NET, запущенной на компьютере.
\nНо прежде чем мы перейдем непосредственно к программированию, давайте рассмотрим случаи, когда это может быть полезно:
\nУправление контроллером EV3 из внешней системы осуществляется путем отправки команд в последовательный порт. Сам формат команд описан в Communication Developer Kit.
\nНо реализация этого протокола вручную — дело скучное. Поэтому можно воспользоваться готовой .NET-оберткой, которую заботливо написал Brian Peek. Исходные коды этой библиотеки размещены на Github, а готовый к использованию пакет можно найти в Nuget.
\nДля связи с контроллером EV3 используется класс Brick. При создании этого объекта в конструктор требуется передать реализацию интерфейса ICommunication — объект, описывающий способ подключения к контроллеру EV3. Доступны реализации UsbCommunication, BluetoothCommunication и NetworkCommunication (подключение через WiFi).
Наиболее популярный способ подключения - через Bluetooth. Рассмотрим поподробнее этот способ подключения.
\nПрежде чем мы сможем программно подключиться к контроллеру через Bluetooth, контроллер необходимо подключить к компьютеру, используя настройки операционной системы.
\nПосле того, как контроллер подключен, идём в настройки Bluetooth и выбираем вкладку COM-порты. Находим наш контроллер, нам нужен исходящий порт. Его и будем указывать при создании объекта BluetoothCommunication.
Код для подключения к контроллеру будет выглядеть так:
\npublic async Task Connect(ICommunication communication)\n{\n var communication = new BluetoothCommunication(\"COM9\");\n var brick = _brick = new Brick(communication);\n await _brick.ConnectAsync();\n}Опционально можно указать таймаут подключения к контроллеру:
\nawait _brick.ConnectAsync(TimeSpan.FromSeconds(5));Подключение к блоку через USB или WiFi осуществляется аналогично, за тем исключением, что используются объекты UsbCommunication и NetworkCommunication.
Все дальнейшие действия, выполняемые с контроллером, осуществляются через объект Brick.
Для выполнения команд на контроллере EV3 обратимся к свойству DirectCommand объекта Brick. Для начала попробуем запустить моторы.
Предположим, что наш мотор подключен к порту A контроллера, тогда запуск этого мотора на мощности 50% будет выглядеть так:
\nawait _brick.DirectCommand.TurnMotorAtPowerAsync(OutputPort.A, 50);Есть и другие методы для управления мотором. Например, можно повернуть мотор на заданный угол, используя методы StepMotorAtPowerAsync() и StepMotorAtSpeedAsync(). Всего доступно несколько методов, которые являются вариациями на режимы включения моторов — по времени, скорости, мощности и т.д.
Принудительная остановка осуществляется методом StopMotorAsync():
await _brick.DirectCommand.StopMotorAsync(OutputPort.A, true);Второй параметр указывает на использование тормоза. Если его установить в false, то мотор будет останавливаться «накатом».
Контроллер EV3 имеет четыре порта для подключения сенсоров. Дополнительно к этому, моторы также имеют встроеные энкодеры, что позволяет использовать их как сенсоры. В итоге мы имеем 8 портов, с которых можно считывать значения.
\nДоступ к портам для считывания значений можно получить через свойство Ports объекта Brick. Ports — это коллекция портов, доступных на контроллере. Поэтому для работы с конкретным портом нужно его выбрать. InputPort.One…InputPort.Four — это порты для датчиков, а InputPort.A…InputPort.D — это энкодеры моторов.
var port1 = _brick.Ports[InputPort.One];Датчики в EV3 могут работать в разных режимах. Например, датчик цвета EV3 можно использовать для измерения внешнего освещения, измерения отраженного света или для определения цвета. Поэтому, чтобы «сообщить» сенсору о том, как именно мы хотим его использовать, нужно задать его режим:
\n_brick.Ports[InputPort.One].SetMode(ColorMode.Reflective);Теперь, когда датчик подключен и режим его работы задан, можно считать из него данные. Получить можно «сырые» данные, обработанное значение и значение в процентах.
\nfloat si = _brick.Ports[InputPort.One].SIValue;\nint raw = _brick.Ports[InputPort.One].RawValue;\nbyte percent = _brick.Ports[InputPort.One].PercentValue;Свойство SIValue возвращает обработанные данные. Здесь все зависит от того, какой именно датчик используется и в каком режиме. Например, при измерении отраженного света мы получим значения от 0 до 100 в зависимости от интенсивности отраженного света (черный/белый).
Свойство RawValue возвращает «сырое» значение, полученное с АЦП. Иногда удобнее использовать именно его для последующей обработки и использования. Кстати, в среде разработки EV3 тоже есть возможность получения «сырых» значений — для этого нужно воспользоваться блоком из синей панели.
Если используемый датчик предполагает получение значений в процентах, то можно также воспользоваться свойством PercentValue.
Предположим, в нашем распоряжении есть робот-тележка с двумя колесами и мы хотим развернуть его на месте. В этом случае два колеса должны вращаться в противоположном направлении. Если мы воспользуемся DirectCommand и последовательно отправим две команды контроллеру, между их выполнением может пройти некоторое время:
await _brick.DirectCommand.TurnMotorAtPowerAsync(OutputPort.A, 50);\nawait _brick.DirectCommand.TurnMotorAtPowerAsync(OutputPort.B, -50);В этом примере мы отправляем команду для вращения мотора A на скорости 50, после успешного окончания отправки этой команды, повторяем то же самое с мотором, подключенным к порту B. Проблема в том, что отправка команд происходит не моментально, поэтому моторы могут начать крутиться в разное время — пока передается команда для порта B, мотора A уже начнет крутиться.
\nЕсли для нас критически важно заставить крутится моторы одновременно, можно отправлять команды контроллеру «пачкой». В этом случае следует воспользоваться свойством BatchCommand вместо DirectCommand:
_brick.BatchCommand.TurnMotorAtPower(OutputPort.A, 50);\n_brick.BatchCommand.TurnMotorAtPower(OutputPort.B, -50);\nawait _brick.BatchCommand.SendCommandAsync();Теперь подготавливается сразу две команды, после чего они отправляются на контроллер одним пакетом. Контроллер, получив эти команды, начнет вращение моторов одновременно.
\nКроме вращения моторов и считывания значений сенсоров, можно выполнять ещё ряд действий на контроллере EV3. Не буду подробно останаливаться на кадом из них, перечислю только список того, что можно сделать:
\nCleanUIAsync(), DrawTextAsync(), DrawLineAsync() и др. — манипуляция встроенным экраном контроллера EV3PlayToneAsync() и PlaySoundAsync() — использование встроенного динамика для воспроизведения звуковWriteFileAsync(), CopyFileAsync(), DeleteFileAsync() (из SystemCommand) — работа с файламиИспользование .NET для управления роботами Mindstorms EV3 хорошо демонстрирует как технологии «из разных миров» могут работать совместно. В качестве результата исследования EV3 API для .NET было создано небольшое приложение, которое позволяет управлять роботом EV3 с компьютера. К сожалению, аналогичные приложения существуют для NXT, а EV3 они обошли стороной. В то же время они полезны на сорвнованиях управляемых роботов, например в футболе роботов.
\n\n\n\n![\"Работаем](\"https://blog.zwezdin.com/2017/mindstorms-ev3-net-api/3a11cf1c/ev3-remote-control@2x.png\")
",
"tags": [
".NET",
"WPF",
"LEGO Mindstorms"
],
"banner_image": "https://blog.zwezdin.com/2017/mindstorms-ev3-net-api/23cc08c8/mindstorms_ev3-net-api@cover.png"
},
{
"id": "https://blog.zwezdin.com/2017/cors-asp-net-core/",
"url": "https://blog.zwezdin.com/2017/cors-asp-net-core/",
"title": "Использование CORS в ASP.NET Core",
"date_published": "2017-02-26T13:00:00.000Z",
"content_html": "По умолчанию браузеры отклоняют AJAX-запросы к адресам, расположенных в других доменах. Но иногда такие запросы необходимы. Для того, чтобы это регулировать придумали CORS.
\nCross Origin Resource Sharing (CORS) — стандарт W3C, который позволяет определить политики кросс-доменных AJAX-запросов. Подробнее про CORS можно почитать здесь и здесь.
\nКак видно из спецификаций, управление политиками CORS происходит за счет дополнительных HTTP-запросов и HTTP-заголовков при осуществлении кросс-доменных запросов. В ASP.NET Core существует готовый пакет для настройки политик CORS, что упрощает работу с кросс-доменными запросами.
\nВ первую очередь следует установить пакет Microsoft.AspNetCore.Cors — в нем находится все необходимое для настройки CORS.
После установки пакета следует зарегистрировать сервис CORS в контейнере ASP.NET:
\npublic void ConfigureServices(IServiceCollection services)\n{\n services.AddCors();\n}Кроме добавления CORS в DI-контейнер, следует указать конвейеру ASP.NET Core о необходимости использования Middleware из пакета Microsoft.AspNetCore.Cors. Сделать это можно вызвав метод UseCors(). В качестве параметра передается выражение, настраивающее политику CORS. Зададим домены, которым можно работать с нашим ресурсом в рамках CORS:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)\n{\n app.UseCors(builder =>\n builder.WithOrigins(\"https://blog.zwezdin.com/\")\n );\n}Параметр builder — это объект CorsPolicyBuilder. С его помощью можно указать как именно должен работать CORS для нашего ресурса. Вся дальнейшая настройка CORS производится с его помощью.
Если вам требуется более тонкая настройка CORS, то следует воспользоваться тем же CorsPolicyBuilder, но задать больше параметров. Например, если в рамках CORS-запросов вы захотите передавать HTTP-заголовки, отличные от стандартных, то такой запрос будет отклонен. Следующая конфигурация позволит работать с нестандартными заголовками, а также указать HTTP-методы, разрешенные для работы и набор хостов-источников:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)\n{\n app.UseCors(builder =>\n builder.WithOrigins(\"https://blog.zwezdin.com/\",\n \"https://google.com\")\n .WithHeaders(\"X-Header1\", \"X-Header1\")\n .WithMethods(\"GET\", \"POST\", \"PUT\")\n );\n}Можно также отменить ограничительную политику и разрешить всё:
\npublic void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)\n{\n app.UseCors(builder =>\n builder.AllowAnyOrigin()\n .AllowAnyHeader()\n .AllowAnyMethod()\n );\n}Пользоваться, однако, такой методикой я бы посоветовал с осторожностью.
\nЕсли предполагается, что отдельные части приложения должны иметь разное поведение для CORS-запросов, то можно воспользоваться политиками. Политики — это именованый набор правил CORS, аналогичный тому, как это описывалось выше. Описание политик производится в методе AddCors() при добавлении сервиса в DI-контейнер:
public void ConfigureServices(IServiceCollection services)\n{\n services.AddCors(cors =>\n {\n cors.AddPolicy(\"Policy1\",\n builder =>\n builder.WithOrigins(\"https://blog.zwezdin.com/\")\n .WithHeaders(\"X-Header1\", \"X-Header1\")\n .WithMethods(\"GET\", \"POST\", \"PUT\"));\n\n cors.AddPolicy(\"Policy2\",\n builder =>\n builder.AllowAnyOrigin()\n .WithMethods(\"GET\"));\n\n cors.AddPolicy(\"Policy3\",\n builder =>\n builder.AllowAnyOrigin()\n .WithHeaders(\"X-Header1\")\n .WithMethods(\"POST\"));\n });\n}Здесь определяется три политики с именами Policy1, Policy2 и Policy3. Далее есть несколько способов как эти политики можно применять.
Можно указать имя политики вместо явной конфигурации при добавлении Middleware.
\npublic void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)\n{\n app.UseCors(\"Policy2\");\n}Такой подход позволяет иметь несколько предопределенных политик и переключать их, например, используя конфигурационный файл.
\nЕсли в приложении используется ASP.NET MVC, то политики CORS можно применять к отдельным контроллерам или действиям:
\n[EnableCors(\"Policy2\")]\npublic class HomeController : Controller\n{\n [EnableCors(\"Policy1\")]\n public IActionResult Index()\n {\n return View();\n }\n\n [EnableCors(\"Policy2\")]\n public IActionResult About()\n {\n return View();\n }\n}Если добавить фильтр CorsAuthorizationFilterFactory глобально, то заданная политика будет применяться ко всем контроллерам/действиям. При этом можно явно указать на какие действия эта политика распространяться не должна:
[EnableCors(\"Policy2\")]\npublic class HomeController : Controller\n{\n [EnableCors(\"Policy1\")]\n public IActionResult Index()\n {\n return View();\n }\n\n [EnableCors(\"Policy2\")]\n public IActionResult About()\n {\n return View();\n }\n\n [DisableCors]\n public IActionResult Contact()\n {\n return View();\n }\n}ASP.NET Core использует новую модель конфигурирования на основе IOptions<>, о чем я писал ранее. Эта модель позволяет считывать конфигурационные параметры отдельными частями приложения. Но где эти данные размещены? Давайте разберемся с этим вопросом.
Startup.csДля начала заглянем в файл Startup.cs — файл, с которого начинается запуск приложения. В стандартном шаблоне проекта ASP.NET Core, в конструкторе класса Startup создается объект ConfigurationBuilder и на его основе строится объект с конфигурационными данными. Этот объект сохраняется в локальное свойство и фактически хранит словарь конфигурационных параметров.
public class Startup\n{\n public Startup(IHostingEnvironment env)\n {\n IConfigurationBuilder builder = new ConfigurationBuilder()\n .SetBasePath(env.ContentRootPath)\n .AddJsonFile(\"appsettings.json\", true, true);\n Configuration = builder.Build();\n }\n\n public IConfigurationRoot Configuration { get; }Внутри класса Startup это свойство затем неоднократно используется для настройки отдельных частей приложения — об этом я писал в предыдущей записи.
Из кода Startup.cs можно понять, что ConfigurationBuilder‘у передается файл appsettings.json, в котором и хранятся настройки приложения. Чем хорош механизм конфигурирования ASP.NET Core — это возможностью использовать одновременно несколько источников данных для конфигурации. Например, можно хранить конфигурацию в нескольких JSON-файлах:
public Startup(IHostingEnvironment env)\n{\n IConfigurationBuilder builder = new ConfigurationBuilder()\n .SetBasePath(env.ContentRootPath)\n .AddJsonFile(\"appsettings.json\", true, true)\n .AddJsonFile(\"another-settings.json\", true, true);Можно также использовать разные типы источников. Например, часть конфигурации хранить в JSON, а другую — в XML:
public Startup(IHostingEnvironment env)\n{\n IConfigurationBuilder builder = new ConfigurationBuilder()\n .SetBasePath(env.ContentRootPath)\n .AddJsonFile(\"appsettings.json\", true, true)\n .AddXmlFile(\"appsettings.xml\", true, true);Из коробки ASP.NET Core предлагает несколько различных способов задания источников конфигурации:
\nEnvironmentVariables — извлекает конфигурационные параметры из переменных окружения операционной системыJSON, XML, Ini — позволяет использовать файлы JSON, XML и INI для хранения конфигруационных параметровUserSecrets — позволяет использовать специальное защищенное хранилище для хранения конфигурационных параметровБазовый набор позволяет организовать гибкую систему конфигурации приложения ASP.NET Core. Но по-настоящему мощным этот инструмент становится за счет возможности его расширения. Другими словами, вы можете создать собственный источник данных для конфигурации приложения и использовать его вместе со встроенными механизмами.
\nВ качестве учебного примера, создадим источник данных, позволяющий хранить конфигурацию в файлах формата YAML.
Реализация собственного источника конфигурации начинается с создания класса, реализующего интерфейс IConfigurationSource:
public class YamlConfigurationSource : IConfigurationSource\n{\n public YamlConfigurationSource(string fileName)\n {\n FileName = fileName;\n }\n\n public string FileName { get; }\n\n public IConfigurationProvider Build(IConfigurationBuilder builder)\n {\n return new YamlConfigurationProvider(this);\n }\n}Основная задача этого класса заключается в получении исходных данных (например, имени конфигруационного файла) и создании объекта ConfigurationProvider для данного источника. Реализацией провайдера займемся чуть позже, а пока давайте сразу добавим методы расширения, чтобы можно было удобно использовать этот источник данных в Startup.cs:
public static class YamlConfigurationSourceExtensions\n {\n public static IConfigurationBuilder AddYamlFile(\n this IConfigurationBuilder builder, string filename)\n {\n return builder.Add(new YamlConfigurationSource(filename));\n }\n }Для реализации провайдера нам потребуется доступ к файловой системе. Поэтому при создании провайдера передадим ссылку на него. Код YamlConfigurationSource изменится следующим образом:
public class YamlConfigurationSource : IConfigurationSource\n{\n public YamlConfigurationSource(string fileName)\n {\n FileName = fileName;\n }\n\n public string FileName { get; }\n\n public IConfigurationProvider Build(IConfigurationBuilder builder)\n {\n return new YamlConfigurationProvider(this, builder.GetFileProvider());\n }\n}Осталось реализовать провайдер для доступа к Yaml. Для этого создадим класс-наследник ConfigurationProvider. Для загрузки данных из источника следует реализовать метод Load:
public class YamlConfigurationProvider : ConfigurationProvider\n{\n private readonly IFileProvider _fileProvider;\n private readonly YamlConfigurationSource _source;\n\n public YamlConfigurationProvider(YamlConfigurationSource source, IFileProvider fileProvider)\n {\n _source = source;\n _fileProvider = fileProvider;\n }\n\n public override void Load()\n {\n }\n}Для работы с Yaml-файлами воспользуемся библиотекой YamlDotNet. Вся суть конфигурационного провайдера сводится к считыванию источника и сохранении конфигурационных значений в служебном словаре, доступном через свойство Data.
public class YamlConfigurationProvider : ConfigurationProvider\n{\n private readonly IFileProvider _fileProvider;\n private readonly YamlConfigurationSource _source;\n\n public YamlConfigurationProvider(YamlConfigurationSource source, IFileProvider fileProvider)\n {\n _source = source;\n _fileProvider = fileProvider;\n }\n\n public override void Load()\n {\n IFileInfo file = _fileProvider.GetFileInfo(_source.FileName);\n using (Stream stream = file.CreateReadStream())\n {\n using (TextReader reader = new StreamReader(stream))\n {\n Dictionary<object, object> document = new DeserializerBuilder()\n .Build()\n .Deserialize(reader) as Dictionary<object, object>;\n\n if (document != null)\n {\n foreach (KeyValuePair<object, object> item in document)\n {\n Data[item.Key.ToString()] = item.Value.ToString();\n }\n }\n }\n }\n }\n}Провайдер готов. Осталось подключить его к приложению в Startup.cs:
public class Startup\n{\n public Startup(IHostingEnvironment env)\n {\n IConfigurationBuilder builder = new ConfigurationBuilder()\n .SetBasePath(env.ContentRootPath)\n .AddJsonFile(\"appsettings.json\", true, true)\n .AddYamlFile(\"config.yml\");\n Configuration = builder.Build();\n }Приведенный выше пример показывает как за несколько минут можно добавить собственный конфигурационный провайдер в приложение ASP.NET Core.
\nОбратите внимание, что этот пример годится только для учебных целей. Например, в нем не реализована обработка вложенных свойств YAML. Кроме того, для реализации конфигурационных источников, которые хранят свои данные в файлах существует ещё одна абстракция - FileConfigurationProvider и FileConfigurationSource. Кроме всего прочего в них реализована возможность отслеживания изменений в конфигурационных файлах. Поэтому, если ваш источник конфигурации использует файлы, то собственный провайдер лучше создавать на основе FileConfigurationProvider.
Большинство веб-разработчиков при отладке приложений используют Google Chrome — это уже ни для кого не секрет. Прежде всего в этом браузере привлекают продвинутые средства для разработчиков. Одним из элементов devtool является консоль, которая в свою очередь гораздо более продвинутая, чем думают о ней большинство разработчиков.
\nКонсоль Google Chrome умеет гораздо больше, чем console.log(). Я опишу некоторые возможности, которые сам применяю чаще всего.
console.log()Вызов console.log() позволяет отобразить в консоли сообщение.
var e = { x: 5 };\nconsole.log('Log message', e);Вызовы info(), warn() и error() позволяют сделать то же самое, визуально выделив сообщение соответствующим стилем. Бывает очень полезно, когда в процессе отладки накапливается большое количество сообщений и трудно выделить какие-то ключевые сообщения.
var e = { x: 5 };\nconsole.log('Hello! I`m a message', e);\nconsole.info('Something happened...', e);\nconsole.warn('Wow! You defenitely should pay attention here!', e);\nconsole.error('Ooooooops....', e);![\"Результат](\"https://blog.zwezdin.com/2016/chrome-dev-console/8e8eb469/console-log-info-warn-error@2x.png\")
Вторым параметром я передал переменную e, содержимое которой также отобразилось в консоли. Chrome позволяет передавать сколько угодно параметров, если вам требуется отобразить не только сообщение, но и состояние каких-либо переменных.
По умолчанию консоль отображает содержимое объекта в виде дерева. Это очень удобно, т.к. вы можете скрывать/раскрывать нужные части объекта и отслеживать в них информацию. Неудобства возникают когда вам нужно отобразить, например, содержимое массива. В этом случае вы получите нечто подобное:
\n\n\n\n![\"Результат](\"https://blog.zwezdin.com/2016/chrome-dev-console/b4567e1a/console-log-elements@2x.png\")
Вместо console.log() в этом случае удобнее использовать console.table(), вот как это выглядит:
var elements = [\n { id: 1, x: 'Lorem', y: 'ipsum'},\n { id: 2, x: 'dolor', y: 'sit'},\n { id: 3, x: 'amet', y: 'consectetur'},\n { id: 4, x: 'adipiscing', y: 'elit'},\n { id: 5, x: 'sed', y: 'do'}\n];\n\nconsole.table(elements);![\"Результат](\"https://blog.zwezdin.com/2016/chrome-dev-console/04ea1b5e/console-table@2x.png\")
Как видно из скриншота, вызов console.table() отображает массив не только в виде таблицы, но и в виде дерева, как при вызове console.log().
Когда сообщения в консоли идут потоком друг за другом бывает полезно объединять их в группы. Делается это путем вызова методов console.group() и console.groupEnd().
console.group('Message processing');\nconsole.log('Message processing started...')\nconsole.warn('Error during processing list element.');\nconsole.log('Done');\nconsole.groupEnd();\n\nconsole.group('Image processing');\nconsole.log('Image processing started...')\nconsole.info('Image size: 500Kb');\nconsole.log('Done');\nconsole.groupEnd();Если вместо console.group() вызвать console.groupCollapsed(), то сообщения в консоли будут свернуты при отображении.
console.group('Message processing');\nconsole.log('Message processing started...')\nconsole.warn('Error during processing list element.');\nconsole.log('Done');\nconsole.groupEnd();\n\nconsole.groupCollapsed('Some other stuff');\nconsole.log('Blah');\nconsole.info('Blah');\nconsole.warn('Blah');\nconsole.groupEnd();\n\nconsole.group('Image processing');\nconsole.log('Image processing started...')\nconsole.info('Image size: 500Kb');\nconsole.log('Done');\nconsole.groupEnd();Ассерты — это распространенный метод проверки утверждения в разных языках программирования. Консоль Google Chrome также предоставляет такую возможность. Чтобы выполнить проверку, нужно вызвать console.assert() с двумя параметрами: первый — проверяемое условие, второй — сообщение об ошибке. Если проверяемое условие ложно, то в консоли появится сообщение об ошибке, иначе ничего не произойдет.
console.assert(1000 > 10, 'It`s true, so nothing will happen at console.');\nconsole.assert(25 < 10, '25 is not less than 10!');![\"Результат](\"https://blog.zwezdin.com/2016/chrome-dev-console/562ce90d/console-assert@2x.png\")
Когда одно и то же сообщение появляется в консоли несколько раз, бывает удобно вести подсчет сколько раз это произошло. С этим отлично справляется console.count().
console.count('Something happened');\nconsole.count('Something happened');\nconsole.count('Something happened');\nconsole.count('Something happened');\nconsole.count('Something happened');\nconsole.count('Something happened');\nconsole.count('Something happened');\nconsole.count('Something happened');![\"Результат](\"https://blog.zwezdin.com/2016/chrome-dev-console/699fa6e6/console-count@2x.png\")
Когда при отладке приложения нужно посмотреть стек вызовов, часто используют точки останова и отладчик. Лично мне это неудобно, я предпочитаю отобразить стек в консоли. Я знаю, что для этого некоторые используют хак вроде такого:
\nconsole.log(new Error().stack);Но на самом деле в Chrome для этого есть специальный метод console.trace().
function f1() {\n console.trace('f1');\n}\n\nfunction f2() {\n f1();\n}\n\nfunction f3() {\n f2();\n}\n\nf3();В этом случае в консоли отобразится доступный стек вызовов. И никаких хаков :-)
\n\n\n\n![\"Результат](\"https://blog.zwezdin.com/2016/chrome-dev-console/fe4d7aa3/console-trace@2x.png\")
Chrome позволяет использовать подстановки в выражениях аналогично тому, как это делается в string.Format() в C# или println() в C.
console.log('Current value: %d', 500);В этом примере %d означает, что здесь подставляется число. Список доступных значений:
%s — строка%i, %d — целое число%f — дробное число%o — DOM-элемент%O — JavaScript-объектаОтдельного внимания заслуживает %c — если указать его при вызове console.log(), то в параметрах можно передать набор CSS-стилей, которые будут использоваться при отображении.
![\"Возможности](\"https://blog.zwezdin.com/2016/chrome-dev-console/30ddbaf5/console-format@2x.png\")
$0Если во вкладке Elements выделить какой-либо элемент в DOM, то к нему можно обратиться через $0 в консоли. Это очень удобный способ, когда нужно быстро выполнить какие-нибудь манипуляции с DOM-элементом.
Долгое время в приложениях .NET для работы с файлами конфигурации использовался объект ConfigurationManager, а каждая секция в конфигурационном файле описывалась через ConfigurationSection. В ASP.NET Core подходы к работе с конфигурационными файлами изменились и на смену пришел интерфейс IOptions.
IOptionsASP.NET Core позволяет описывать конфигурацию в виде простых .NET-объектов, освобождая нас от необходимости использовать дополнительные атрибуты и наследование (как это было с ConfigurationSection). Доступ к конфигурации в таком случае осуществляется путем внедрением зависимости IOptions<> в нужный компонент.
Для пример создадим объект с нужными для нас свойствами конфигруации:
\npublic class OwnerOptions\n{\n public string Account { get; set; }\n\n public string DisplayName { get; set; }\n\n public string Email { get; set; }\n}Для получения доступа к конфигурации, например, из контроллера достаточно будет просто внедрить IOptions<> в контроллер:
public class HomeController : Controller\n{\n private readonly IOptions<OwnerOptions> _ownerOptions;\n\n public HomeController(IOptions<OwnerOptions> ownerOptions)\n {\n _ownerOptions = ownerOptions;\n }Доступ к свойствам этого объекта осуществляется через свойство Value:
public IActionResult Index()\n {\n return View(new\n {\n Account = _ownerOptions.Value.Account\n });\n }Заполние содержимым options-объектов происходит в момент запуска приложения. В startup.cs для этого существует специальный метод ConfigureServices().
Чтобы сконфигурировать нужный объект следует воспользоваться методом Configure<>() интерфейса IServiceCollection:
public void ConfigureServices(IServiceCollection services)\n{\n services.Configure<OwnerOptions>(...);\n}В зависимости от ситуации настраивать объекты конфигурации можно разными способами. В каждом случае используется своя перегрузка метода Configure().
Для заполнения значений из кода в метод Configure() следует передать Action, внутри которого задаются нужные значения:
public class OwnerOptions\n{\n public string Account { get; set; }\n\n public string DisplayName { get; set; }\n\n public string Email { get; set; }\n}\n\npublic class Startup\n{\n public void ConfigureServices(IServiceCollection services)\n {\n services.Configure<OwnerOptions>(options =>\n {\n options.Account = \"local\";\n options.DisplayName = \"Local account\";\n options.Email = \"noreply@local.account\";\n });Для заполнения значений из конфигурационного файла в метод Configure() следует передать свойство Configuration, которое определено в классе Startup:
public class WebsiteOptions\n{\n public string Domain { get; set; }\n}\n\npublic class Startup\n{\n public IConfigurationRoot Configuration { get; }\n\n public void ConfigureServices(IServiceCollection services)\n {\n services.Configure<WebsiteOptions>(Configuration);В этом случае значения для каждого свойства options-объекта будут сопоставляться ключам в конфигурационном файле. Поэтому в стандартный конфигурационный файл appsettings.json добавим свойство Domain, которое присутствует в WebsiteOptions.
{\n \"Domain\": \"localhost\"\n}Этот случай очень похож на предыдущий за исключением того, что options-объект заполняется данными нужной конфигурационной секции. В метод Configure() передается не весь объект Configuration, а только конкретная его секция:
public class ConnectionStringOptions\n{\n public string DefaultConnection { get; set; }\n}\n\npublic class Startup\n{\n public IConfigurationRoot Configuration { get; }\n\n public void ConfigureServices(IServiceCollection services)\n {\n services.Configure<ConnectionStringOptions>(Configuration.GetSection(\"ConnectionStrings\"));Файл appsettings.json будет иметь следующий вид:
{\n \"ConnectionStrings\": {\n \"DefaultConnection\": \"Server=(localdb)\\\\mssql;Database=aspnet-webapp;Trusted_Connection=True;MultipleActiveResultSets=true\"\n }\n}Интерфейс IOptions предоставляет простой и в то же время гибкий способ определения конфигурационных параметров приложения. Это — эволюция объекта ConfigurationSection, использовавшегося до текущего момента.
Полная версия приложения, использующего одновременно три способа:
\nstartup.cs
public class Startup\n{\n public IConfigurationRoot Configuration { get; }\n\n public void ConfigureServices(IServiceCollection services)\n {\n services.Configure<OwnerOptions>(options =>\n {\n options.Account = \"local\";\n options.DisplayName = \"Local account\";\n options.Email = \"noreply@local.account\";\n });\n\n services.Configure<WebsiteOptions>(Configuration);\n\n services.Configure<ConnectionStringOptions>(\n Configuration.GetSection(\"ConnectionStrings\"));\n }appsettings.json
{\n \"ConnectionStrings\": {\n \"DefaultConnection\": \"Server=(localdb)\\\\mssql;Database=aspnet-webapp;Trusted_Connection=True;MultipleActiveResultSets=true\"\n },\n \"Domain\": \"localhost\"\n}HomeController.cs
public class HomeController : Controller\n{\n private readonly IOptions<OwnerOptions> _ownerOptions;\n private readonly IOptions<WebsiteOptions> _websiteOptions;\n private readonly IOptions<ConnectionStringOptions> _connectionStringOptions;\n\n public HomeController(IOptions<OwnerOptions> ownerOptions,\n IOptions<WebsiteOptions> websiteOptions,\n IOptions<ConnectionStringOptions> connectionStringOptions)\n {\n _ownerOptions = ownerOptions;\n _websiteOptions = websiteOptions;\n _connectionStringOptions = connectionStringOptions;\n }\n\n public IActionResult Index()\n {\n return View(new IndexViewModel\n {\n Owner = _ownerOptions.Value,\n Website = _websiteOptions.Value,\n ConnectionString = _connectionStringOptions.Value\n });\n }IApplicationLifetime — это новый интерфейс в ASP.NET Core. С его помощью можно корректно обрабатывать моменты запуска и завершения ASP.NET приложения.
Интерфейс определен следующим образом:
\nnamespace Microsoft.AspNetCore.Hosting\n{\n public interface IApplicationLifetime\n {\n CancellationToken ApplicationStarted { get; }\n\n CancellationToken ApplicationStopping { get; }\n\n CancellationToken ApplicationStopped { get; }\n\n void StopApplication();\n }\n}Интерфейс по умолчанию пристутствует в DI-контейнере, поэтому его можно инжектировать в том месте, где это необходимо, например в классе Startup:
public class Startup\n{\n public void Configure(IApplicationBuilder app,\n IHostingEnvironment env,\n IApplicationLifetime applicationLifetime,\n ILoggerFactory loggerFactory)\n {\n }\n}Или в контроллере:
\npublic class HomeController : Controller\n{\n public HomeController(IApplicationLifetime applicationLifetime)\n {\n }IApplicationLifetime содержит три свойства CancellationToken:
ApplicationStarted − срабатывает когда хост приложения полностью запущен.ApplicationStopping − срабатывает когда хост приложения инициирует процедуру завершения. В этот момент запросы от пользователей могут всё ещё обрабатываться.ApplicationStopped − срабатывает после завершения приложения. В этот момент все запросы от пользователей обработаны.Используя CancellationToken можно зарегистрировать обработчик:
public class Startup\n{\n public void Configure(IApplicationBuilder app,\n IHostingEnvironment env,\n IApplicationLifetime applicationLifetime,\n ILoggerFactory loggerFactory)\n {\n applicationLifetime.ApplicationStarted.Register(OnApplicationStarted);\n applicationLifetime.ApplicationStopping.Register(OnApplicationStopping);\n applicationLifetime.ApplicationStopped.Register(OnApplicationStopped);\n }\n\n protected void OnApplicationStarted()\n {\n }\n\n protected void OnApplicationStopping()\n {\n }\n\n protected void OnApplicationStopped()\n {\n }\n}ApplicationStopping и ApplicationStopped блокируют дальнейшее завершение приложения до тех пор, пока не исполнен обработчик.
Дополнительно IApplicationLifetime имеет метод StopApplication(). С его помощью можно инициировать процесс завершения приложения.
public class HomeController : Controller\n{\n private readonly IApplicationLifetime _applicationLifetime;\n\n public HomeController(IApplicationLifetime applicationLifetime)\n {\n _applicationLifetime = applicationLifetime;\n }\n\n public IActionResult Shutdown()\n {\n _applicationLifetime.StopApplication();\n return View();\n }Когда мы говорим о DevOps рано или поздно речь заходит о трансформации конфигурационных файлов. В мире .NET стандартом де-факто для конфигурационных файлов всегда был XML. А для трансформации XML-файлов был придуман XML Document Transform.
\nПоявление .NET Core сместило многие акценты в мире .NET-разработки, включая работу с файлами конфигурации. XML, конечно же, поддерживается до сих пор. Однако, в качестве основного формата предлагается использовать JSON.
В .NET Core предполагается, что у вашего приложения есть несколько сред исполнения. Для каждого случая мы можем создать отдельный конфигурационный файл и положить туда нужные нам значения. Пусть, например, у нас есть файл appsettings.json и две среды исполнения, тогда конфигурационные файлы будут иметь следующие имена:
appsettings.Development.json − конфигурация для среды Developmentappsettings.Production.json − конфигурация для среды ProductionТакой подход решает задачу подмены значений в конфигурацинных файлах, но лично мне в этом не нравится как минимум два момента:
\nappsettings.json, appsettings.Development.json, appsettings.Production.json на каждом из серверов. Т.е. пароли и ключи для продакшн-ресурсов у вас будут также находится на серверах для тестирования.По этим причинам, трансформация конфигурационных файлов была бы предпочтительнее подмены файлов. И если с трансформацией XML всё понятно, то для JSON я таких инструментов не нашел. Поэтому тихим июньским субботним утром было решено изобретать свой велосипед на эту тему. О том, что из этого получилось — далее.
![\"Трансформация](\"https://blog.zwezdin.com/2016/config-transformations-with-magic-chunks/d2879a6e/many-people-still-invent-a-bike@2x.jpg\")
\n\n\n\n\n«Каким образом можно универсально представить трансформации» — именно этот вопрос встал в первую очередь. Чтобы не усложнять, в качестве рабочей идеи было принято представление трансформаций в виде последовательности «ключ − значение».
\nДопустим у вас есть следующий конфигурационный файл:
\n<configuration>\n <system.web>\n <compilation debug=\"true\" targetFramework=\"4.5.1\" />\n <authentication mode=\"None\" />\n </system.web>\n</configuration>Чтобы изменить отдельные его части, мы указываем путь внутри файла и задаем для него значение. Разделителем является /. Например:
configuration/system.web/compilation/@debug → falseconfiguration/system.web/authentication/@mode → FormsПосле трансформации файл конфигурации будет выглядеть так:
\n<configuration>\n <system.web>\n <compilation debug=\"false\" targetFramework=\"4.5.1\" />\n <authentication mode=\"Forms\" />\n </system.web>\n</configuration>Приняв эту идею за основу, я сделал небольшую .NET-сборку, которая принимает на вход исходный файл и набор трансформаций, а на выходе выдает изменненый конфигурационный файл.
\nТакой подход позволяет трансформировать конфигурационные файлы независимо от того, к какому типу они относятся. На данный момент поддерживаются — XML, JSON и YAML. А для того, чтобы это можно было максимально удобно интегрировать в конкретный процесс сборки, было создано несколько разных оберток.
\nЧтобы запустить трансформацию конфигов внутри MSBuild-скрипта нужно загрузить последнюю версию Magic Chunks или установить её из Nuget.
После этого в ваш msbuild-файл следует внести несколько изменений:
Шаг 1: Импортировать MagicChunks.targets файл:
<Import Project=\"tools\\MagicChunks.targets\" />Шаг 2: Определить коллекцию трансформаций. В MSBuild это можно сделать при помощи ItemGroup:
<ItemGroup>\n <TransformsXml Include=\"configuration/system.web/authentication/@mode\">\n <Value>Forms</Value>\n </TransformsXml>\n <TransformsXml Include=\"configuration/system.web/httpRuntime\">\n <Value>125</Value>\n </TransformsXml>\n ...\n</ItemGroup>Шаг 3: Запустить трансформацию:
\n<TransformConfig Path=\"Web.config\" Trasformations=\"@(TransformsXml)\" />По умолчанию будет изменен исходный файл (в данном примере — Web.config). Если результат требуется сохранить в другом файле, то дополнительно следует задать атрибут Target:
<TransformConfig Path=\"Web.config\" Target=\"App.config\" Trasformations=\"@(TransformsXml)\" />Пример запуска трансформаций при помощи MSBuild − samples/msbuild
Powershell — очень популярный инструмент для сборки проектов. Поэтому Magic Chunks имеет готовый модуль для Powershell. Потребуется загрузить последнюю версию Magic Chunks или установить её из Nuget.
После загрузки следует выполнить следующие шаги:
\nШаг 1: Импортировать модуль MagicChunks.psm1:
Import-Module \".\\MagicChunks.psm1\";Шаг 2: Запустить команду Format-MagicChunks с нужными параметрами:
Format-MagicChunks -path \"$PSScriptRoot\\Web.config\" `\n -target \"$PSScriptRoot\\Web.transformed.1.config\" -transformations @{\n \"configuration/system.web/authentication/@mode\" = \"Forms\";\n \"configuration/system.web/httpRuntime\" = \"125\";\n}Пример запуска трансформаций при помощи Powershell − samples/powershell
PSake — надстройка над Powershell, позволяющая писать билд-скрипты чуть более удобно. Поэтому запуск трансформаций производится так же, как в Powershell. Код, приведенный выше актуален и в данном случае.
Пример запуска трансформаций при помощи PSake − samples/psake
Cake (C# Make) — инструмент, позволяющий создавать билд-скрипты на языке C#. Чтобы подключить Magic Chunks к скрипту на Cake следует выполнить следующие шаги:
Шаг 1: Добавить ссылку на Magic Chunks:
#addin \"MagicChunks\"Шаг 2: Запустить трансформацию, используя алиас TransformConfig:
Task(\"Default\")\n .Does(() => {\n\n TransformConfig(@\"Web.config\", \"Web.transformed.1.config\",\n new TransformationCollection {\n { \"configuration/system.web/authentication/@mode\", \"Forms\" },\n { \"configuration/system.web/httpRuntime\", \"125\" }\n });\n\n });Пример запуска трансформаций при помощи Cake − samples/cake
Иногда может потребоваться произвести трансформацию из .NET-кода. Сделать это очень просто, т.к. Magic Chunks — это и есть сборка .NET:
Шаг 1: Устанавливаем Magic Chunks из Nuget:
Install-Package MagicChunksШаг 2: Создаем объект MagicChunks.Core.Transformer:
using MagicChunks.Core;\n\nvar transformer = new Transformer();Шаг 3: Выполняем трансформацию:
\nstring result = transformer.Transform(File.ReadAllText(@\"Web.config\"),\n new TransformationCollection\n {\n {\"configuration/system.web/authentication/@mode\", \"Forms\"},\n {\"configuration/system.web/httpRuntime\", \"125\"}\n });Пример запуска трансформаций внутри .NET-проекта − samples/netapp
\nДля тех, кто используется Team Foundation Server или Visual Studio Online для сборки своего проекта, будет удобно использовать готовый плагин для трансформации. Сделать это весьма просто:
\nШаг 1: Устанавливаем плагин из Visual Studio Marketplace.
\nШаг 2: Добавляем новый шаг сборки:
\n\n\n\n![\"Трансформация](\"https://blog.zwezdin.com/2016/config-transformations-with-magic-chunks/f8b19342/vsts-step2@2x.png\")
\n\n\n\n\nШаг 3: Выбираем Config transformation в группе Utility:
![\"Трансформация](\"https://blog.zwezdin.com/2016/config-transformations-with-magic-chunks/95be08cd/vsts-step3@2x.png\")
\n\n\n\n\nШаг 4:” Указываем путь до файла, который нужно трансформировать, а также набор трансофрмаций в виде JSON-коллекции:
![\"Трансформация](\"https://blog.zwezdin.com/2016/config-transformations-with-magic-chunks/ca60c76b/vsts-step4@2x.png\")
\n\n\n\n\nШаг 5: Запускаем сборку.
\nПоскольку TFS на данный момент не имеет элементов управления для работы с коллекциями «ключ - значение», трансформации представляются в виде JSON-коллекции:
{\n \"configuration/system.web/compilation/@debug\": \"false\",\n \"configuration/system.web/authentication/@mode\": \"Forms\"\n}В качестве значений можно использовать переменные TFS:
\n{\n \"configuration/appSettings/add[@key='builtBy']/@value\": \"$(Build.QueuedBy)\"\n}Видео о том, как настроить трансформацию в TFS за 30 секунд:
", "tags": [ "Tools", "ASP.NET", ".NET", "Powershell", "Team Foundation Server", "Visual Studio Team System", "Open Source", ".NET Core" ], "banner_image": "https://blog.zwezdin.com/2016/config-transformations-with-magic-chunks/69189442/config_transformations-with-magic-chunks@cover.png" }, { "id": "https://blog.zwezdin.com/2016/xamarin-now-is-free/", "url": "https://blog.zwezdin.com/2016/xamarin-now-is-free/", "title": "Xamarin стал бесплатным", "date_published": "2016-03-31T19:00:00.000Z", "content_html": "В конце февраля Скотт Гатри объявил о покупке Xamarin, популярного фреймворка для создания кросс-платформенных мобильных приложений, корпорацией Microsoft. Никакой конкретики тогда не прозвучало и Скотт предложил подождать конференции //Build.
\nКак и ожидалось, на конференции Microsoft озвучили много интересных новостей, одна из которых посвящена Xamarin. Microsoft официально объявили — Xamarin будет распространяться бесплатно и откроет код Xamarin SDK.
\nXamarin Studio Community — бесплатный вариант лицензирования Xamarin, когда библиотека поставляется вместе с бесплатной редакцией Visual Studio Community. В этой редакции разработчики могут создавать приложения в Visual Studio (для Windows) и Xamarin Studio (для Mac). В распоряжении имеются библиотеки Xamarin.Forms, Xamarin.iOS, Xamarin.Android. Для подписчиков MSDN существуют и более продвинутые версии.
\nДля мобильных разработчиков это отличная новость. Подписчики MSDN теперь могут не тратить ежегодно весьма значительные суммы на покупку Xamarin. А для тех, у кого нет подписки MSDN теперь существует бесплатная редакция Xamarin, в которой больше нет ограничения на размер кода.
\nИндустрия выиграет от такого поворота событий. Цена на Xamarin была сдерживающим фактором для распространения Xamarin. Даже удивительно почему Microsoft не сделала это года на два раньше.
", "tags": [ "Мобильная разработка" ], "banner_image": "https://blog.zwezdin.com/2016/xamarin-now-is-free/c133c2af/xamarin_now-is-free@cover.jpg" }, { "id": "https://blog.zwezdin.com/2016/running-chakracore/", "url": "https://blog.zwezdin.com/2016/running-chakracore/", "title": "Запускаем JavaScript-код внутри .NET-приложения, используя ChakraCore", "date_published": "2016-03-26T13:00:00.000Z", "content_html": "Бибилотеку ChakraCore можно использовать для встраивания в собственные приложения. Благодаря этому ваше приложение научится запускать произвольный Javascript-код.
\nКод ChakraCore написан на C++. Поэтому не представляет особого труда импортировать эту библиотеку в собственные проекты C++. Можно использовать PInvoke и запускать этот код из среды .NET.
В первую очередь готовим библиотеку ChakraCore.dll — это и есть движок CharkCore. Проект распростарняется в виде исходного кода, поэтому его нужно загрузить себе и собрать.
Build\\Chakra.Core.sln.x86, x64 или ARM. Если приложение будет запускаться на нескольких платформах, нужно собрать разные собрки.Build\\VcBuild\\bin\\platform забираем файл ChakraCore.dll - он потребуется нам на следующем шаге.ChakraCore.dll — это не .NET-сборка. Поэтому нам потребуются .NET-обертки для запуска кода. К нашему удобству такие обертки доступны среди примеров использования ChakraCore.
ChakraCore.dll.ChakraCore.dll.Для доступа к ChakraCore используется объект JavaScriptRuntime. После завершения работы, этот объект необходимо освободить, поэтому обернем его в using.
JavaScriptRuntime runtime;\nNative.JsCreateRuntime(JavaScriptRuntimeAttributes.None, null, out runtime);\n\nusing (runtime)\n{\n // ...\n}Определяем контекст исполнения JS-кода:
\nJavaScriptSourceContext currentSourceContext = JavaScriptSourceContext.FromIntPtr(IntPtr.Zero);\nJavaScriptContext context;\nNative.JsCreateContext(runtime, out context);\nNative.JsSetCurrentContextИ запускаем:
\nJavaScriptValue result;\nNative.JsRunScript(script, currentSourceContext++, \"\", out result);Не забываем, что мы работаем с нативной библиотекой, поэтому данные нам вернуться в виде указателей на результат. Нехитрыми преобразованиями получаем из них .NET-объект:
\nIntPtr resultPtr;\nUIntPtr stringLength;\nNative.JsStringToPointer(resultJSString, out resultPtr, out stringLength);\n\nNative.JsSetCurrentContext(JavaScriptContext.Invalid);\n\nstring result = Marshal.PtrToStringUni(resultPtr);В моем случае в качестве примера используется консольное приложение. При запуске приложения получаем от пользователя два числа и просим Javascript-функцию сложить их. Результат выводим в консоль.
\nstatic void Main(string[] args)\n{\n int a = int.Parse(Console.ReadLine());\n int b = int.Parse(Console.ReadLine());\n\n string script = String.Format(\n \"((a, b)=>{\" +\n \"return a+b;\" +\n \"})({0}, {1})\", a, b);\n\n string result = RunJavascript(script);\n\n Console.WriteLine(result);\n Console.Read();\n}\n\nprivate static string RunJavascript(string script)\n{\n JavaScriptRuntime runtime;\n Native.JsCreateRuntime(JavaScriptRuntimeAttributes.None, null, out runtime);\n\n using (runtime)\n {\n JavaScriptSourceContext currentSourceContext = JavaScriptSourceContext.FromIntPtr(IntPtr.Zero);\n\n JavaScriptContext context;\n Native.JsCreateContext(runtime, out context);\n\n Native.JsSetCurrentContext(context);\n\n JavaScriptValue result;\n Native.JsRunScript(script, currentSourceContext++, \"\", out result);\n\n JavaScriptValue resultJSString;\n Native.JsConvertValueToString(result, out resultJSString);\n\n IntPtr resultPtr;\n UIntPtr stringLength;\n Native.JsStringToPointer(resultJSString, out resultPtr, out stringLength);\n\n Native.JsSetCurrentContext(JavaScriptContext.Invalid);\n\n return Marshal.PtrToStringUni(resultPtr);\n }\n}Результат:
\n\n\n\n![\"Запускаем](\"https://blog.zwezdin.com/2016/running-chakracore/f0cfdd46/1@2x.png\")
",
"tags": [
".NET",
"JavaScript"
],
"banner_image": "https://blog.zwezdin.com/2016/running-chakracore/9a4cb123/running_chakracore@cover.jpg"
},
{
"id": "https://blog.zwezdin.com/2016/web-app-deployment-with-git-kudu/",
"url": "https://blog.zwezdin.com/2016/web-app-deployment-with-git-kudu/",
"title": "Kudu: Деплой веб-проектов при помощи Git",
"date_published": "2016-03-12T13:00:00.000Z",
"content_html": "Деплой приложения — неизбежный этап в жизненном цикле приложения. Так или иначе вы выполняете деплой, когда показываете приложение миру.
\nВ индустрии нет единого мнения об инструментах для развертывания. Рассмотрим некоторые из них:
\nПлатные инструменты вроде Octopus Deploy — насколько мне известно работают вполне исправно и для крупных компаний это может быть вполне хорошим вариантом. Для тех, кто не может себе позволить платить сотни долларов только за деплой этот способ не подходит.
\nКак процесс деплоя должен выглядеть в идеале:
\nВ идеале инструмент не должен требовать шаманского бубна при настройке, а если что-то пошло не так, то показывать понятные сообщения об ошибке.
\nПроект Kudu появился как часть инфраструктуры Azure для деплоя Azure Websites, используя Git. Использовать в качестве транспорта для деплоя Git − известную большинству разработчиков систему контроля версий − отличная идея! Не нужно изучать новый синтаксис или структуру пакета, вы уже знакомы с этим.
\nKudu работает гениально просто:
\nЕсли ваше приложение находится в Azure Websites, все это для вас уже готово − вам лишь остается отправить изменения в репозиторий.
\nУстановка и настройка Kudu — процесс простой и безболезненный. Ниже несколько шагов, которые нужно для этого выполнить.
\nЗагружаем последнюю версию проекта с GitHub:
\ngit clone https://github.com/projectkudu/kuduЗапускаем Visual Studio и открываем проект Kudu.sln. Собираем. Можно также обойтись без Visual Studio — запустить build.cmd и скрипт соберет проект для вас.
Kudu.Web — это проект, который нужно разместить в IIS после сборки.
![\"Kudu:](\"https://blog.zwezdin.com/2016/web-app-deployment-with-git-kudu/4de61e80/1@2x.png\")
\n\n\n\n\nОбратимся к созданному сайту через браузер — в нем пока нет ни одного приложения. На странице Admin можно увидеть расположение приложение Kudu, а также папку, в которую будут размещены все новые приложения.
![\"Kudu:](\"https://blog.zwezdin.com/2016/web-app-deployment-with-git-kudu/d064558f/2@2x.png\")
\n\n\n\n\nПо умолчанию папка для приложений — app. Можно изменить этот путь в настройках Web.config для Kudu.Web.
Следует убедиться, что текущий пользователь в IIS имеет права на запись в эту папку. Иначе Kudu не сможет создавать и деплоить проекты.
\nВ Kudu Dashboard переходим на страницу Create Application и указываем имя приложения. Нажимаем Create applciation.
При создании приложения Kudu создает в IIS два приложения — kudu_имяприложения и kudu_service_имяприложения.
Первое — приложение, которое требуется деплоить. Второе — сервисное приложение. Оно отображает информацию о проекте, историю коммитов и другую служебную информацию. Оно же хостит git-репозиторий.
\n\n\n\n![\"Kudu:](\"https://blog.zwezdin.com/2016/web-app-deployment-with-git-kudu/fba0c8b9/3@2x.png\")
\n\n\n\n\nКлонируем репозиторий проекта:
\ngit clone http://localhost:45857/coolapp.gitДобавляем файлы в папку проекта и выполняем коммит:
\ngit commit -am “Initial commit”Пушим изменения.
\ngit push origin masterПроверяем результат:
\n\n\n\n![\"Kudu:](\"https://blog.zwezdin.com/2016/web-app-deployment-with-git-kudu/7f18006e/4@2x.png\")
\n\n\n\n\nКаждый коммит в репозиторий — это изменение состояние приложения. Как следствие, мы имеем историю всех деплоев приложения в виде понятной истории коммитов. В свою очередь это позволяет нам быстро откатиться на нужный шаг назад, если приложением возникли проблемы.
", "tags": [ "ASP.NET", "DevOps", "Git" ], "banner_image": "https://blog.zwezdin.com/2016/web-app-deployment-with-git-kudu/998cf19b/web_app-deployment-with-git-kudu@cover.png" }, { "id": "https://blog.zwezdin.com/2016/dotnet-core/", "url": "https://blog.zwezdin.com/2016/dotnet-core/", "title": ".NET Core 1.0 и ASP.NET Core 1.0", "date_published": "2016-01-23T13:00:00.000Z", "content_html": "В феврале прошлого года весь мир узнал о перспективах платформы ASP.NET. Новая версия ASP.NET впечатляет: кросс-платформенность, логичный рантайм на OWIN, модульность (прощай монструозный System.Web), интеграция с популярными инструментами разработки (Grunt, Gulp, NPM), встроенный DI и прочие вкусности. В дополнение к этому, было объявлено об открытии исходных кодов фреймворка. Тогда это называлось ASP.NET vNext, а затем ASP.NET 5. MVC получила версию 6.
\nКоллеги, которые не очень тщательно следят за новостями постоянно путались: « — Новый ASP.NET, который пятый. — Ты имеешь в виду MVC 6? — Да, шестая MVC, которая пятый ASP.NET».
\nМежду тем ASP.NET 5 — это не просто очередная версия. Это — переосмысление всей платформы: поменялся API, способы хостинга приложения, рантайм. По характеру и объему изменений, этой версии, наверное, можно было бы давать номер 10 :-)
\nЧтобы отразить это изменение, названия и номер версии новой платформы изменен:
\nЧто же, теперь название более точно отражает суть.
", "tags": [ "ASP.NET", ".NET", ".NET Core" ], "banner_image": "https://blog.zwezdin.com/2016/dotnet-core/0c20e680/dotnet_core@cover.jpg" }, { "id": "https://blog.zwezdin.com/2016/chakracore-is-open-sourced/", "url": "https://blog.zwezdin.com/2016/chakracore-is-open-sourced/", "title": "Открыт исходный код JavaScript-движка Microsoft Edge", "date_published": "2016-01-17T13:00:00.000Z", "content_html": "Microsoft продолжает открывать код своих проектов. На этот раз в открытом доступе оказался код ChakraCore — Javascript-движка, используемого в новом браузере Microsoft Edge. Код проекта размещен на GitHub. Это означает, что каждый разработчик теперь может внести свой вклад в проект.
\nК проекту прилагается дорожная карта, которая показывает как проект будет развиваться в ближайшем будущем. Одним из пунктов дорожной карты является запуск и поддержка кода Node.js, что намекает на то, что Microsoft посоревнуется с V8 в этой нише.
\nСудя по истории коммитов, работа над проектом кипит и сообщество играет в нем важную роль. Остается только пожелать разработчиком удачи и терпения в этом нелегком деле.
", "tags": [ "JavaScript", "Open Source" ], "banner_image": "https://blog.zwezdin.com/2016/chakracore-is-open-sourced/dbe94a53/chakracore_is-open-sourced@cover.jpg" }, { "id": "https://blog.zwezdin.com/2016/aspnet5-http-platform-handler/", "url": "https://blog.zwezdin.com/2016/aspnet5-http-platform-handler/", "title": "Модель хостинга в ASP.NET 5", "date_published": "2016-01-10T13:00:00.000Z", "content_html": "В ASP.NET 5 существенно поменялась модель хостинга приложения внутри веб-сервера. В предыдущих версиях ASP.NET за хостинг приложения отвечали модули, которые являются частью IIS. В ASP.NET 5 эта часть вынесена из веб-сервера в отдельную библиотеку — HTTP Platform Handler.
\nПриложение на ASP.NET 5 в корне содержит файл web.config, который указывает веб-серверу использовать HTTP Platform Handler:
<configuration>\n <system.webServer>\n <handlers>\n <add name=\"httpplatformhandler\" path=\"*\" verb=\"*\" modules=\"httpPlatformHandler\" resourceType=\"Unspecified\" />\n </handlers>\n <httpPlatform processPath=\"..\\approot\\web.cmd\" arguments=\"\" stdoutLogEnabled=\"false\" stdoutLogFile=\"..\\logs\\stdout.log\" startupTimeLimit=\"3600\"></httpPlatform>\n </system.webServer>\n</configuration>Такой подход предполагает наличие установленной библиотеки HTTP Platform Handler на сервере, где запускается приложение. Когда вы устанавливаете ASP.NET Tools на локальный компьютер, HTTP Platform Handler устанавливается вместе с ними и IIS корректно регаирует на этот способ хостинга.
\nОднако, если вы перенесете это приложение на сервер, то обнаружите ошибку при запуске приложения. Все потому, что HTTP Platform Handler там не установлен. Вот две ссылки для загрузки установочного пакета HTTP Platform Handler:
\n\nВ web.config можно задать переменные окружения, которые будут использоваться при запуске приложения. Это значение можно использовать внутри приложения, чтобы менять поведение в процессе работы.
<httpPlatform processPath=\"..\\approot\\web.cmd\" arguments=\"\" stdoutLogEnabled=\"false\" stdoutLogFile=\"..\\logs\\stdout.log\" startupTimeLimit=\"3600\">\n <environmentVariables>\n <environmentVariable name=\"environment\" value=\"prod\" />\n </environmentVariables>\n</httpPlatform>Razor — неотъемлемая часть ASP.NET. Он позволяет динамически генерировать HTML-разметку, используя конструкции языка C#. Но так ли уж хорош синтаксис Razor для описания сложных сценариев?
\nДавайте взглянем на следующий код:
\n@foreach (var item in items) {\n <li @(item.IsActive ? \"class=\\\"active\\\"\" : string.Empty)>@item.name</li>\n}Видно, что конструкция для пометки элемента списка классом active нагромождает код и уменьшает его читаемость. Код ухудшается, если нужно управлять набором из нескольких классов:
\n@foreach (var item in items) {\n var cl = new List<string>();\n if (item.IsActive)\n cl.Add(\"active\");\n\n if (item.IsFeatured)\n cl.Add(\"featured\");\n\n <li @(cl.Any() ? \"class=\\\"\" + String.Join(\" \", cl.ToArray() + \"\\\"\" : string.Empty)>@item.name</li>\n}Можно использовать собственные хелперы, но это тоже не всегда лучшим образом отражается на читаемости кода.
\nДля решения этой проблемы в ASP.NET 5 появились специальные объекты — Tag Helpers. Они позволяют вынести сложную логику из шаблона Razor в небольшие классы, а в разметке оставить только HTML-атрибуты. К примеру, приведенный выше код мог бы быть переписан вот так:
\n@foreach (var item in items) {\n <li asp-active=\"@item.IsActive\" asp-featured=\"@item.IsFeatured\">@item.name</li>\n}С ASP.NET уже поставляется базовый набор хелперов. Но вся сила тег хелперов в простоте их создания в конкретно вашей ситуации.
\nКаждый хелпер — это небольшой объект, унаследованный от TagHelper. Также при помощи атрибута HtmlTargetElement мы должны указать в каких ситуациях применим этот тег хелпер.
[HtmlTargetElement(\"li\", Attributes = \"asp-active, asp-featured\")]\npublic class ItemTagHelper : TagHelper\n{\n}Простейший тег-хелпер готов. Пока он ничего не делает, но к этому мы вернемся чуть позже. А пока давайте сообщим ASP.NET, что мы создали собственный хелпер.
\nДля подключения тег-хелпера появилась директива @addTagHelper. Чтобы использовать тег хелпер, мы должны добавить его при помощи этой директивы в разметке страницы. Если мы хотим использовать этот хелпер на всех страницах приложения, то вызов @addTagHelper можно добавить в файл _ViewImports.cshtml:
@addTagHelper \"*, WebApplication15\"Таким вызовом мы добавляем все тег-хелперы из указанной сборки.
\nВернемся к реализации логики хелпера. Нам требуется получить значения атрибутов asp-active и asp-featured. Для этого добавим два свойства в класс хелпера и пометим их атрибутом HtmlAttributeName — это укажет на то, что эти свойства нужно заполнить значениями этих HTML-атрибутов.
[HtmlTargetElement(\"li\", Attributes = \"asp-active, asp-featured\")]\npublic class ItemTagHelper : TagHelper\n{\n [HtmlAttributeName(\"asp-active\")]\n public bool Active { get; set; }\n\n [HtmlAttributeName(\"asp-featured\")]\n public bool Featured { get; set; }\n}Работа тег хелпера предполагает модификацию исходного HTML-элемента (иначе зачем нам вообще нужен хелпер). В нашем примере мы хотим превратить значение атрибутов asp-active и asp-featured в набор CSS-классов.
Чтобы добавить логику работы хелпера, достаточно реализовать метод Process:
[HtmlTargetElement(\"li\", Attributes = \"asp-active, asp-featured\")]\npublic class ItemTagHelper : TagHelper\n{\n [HtmlAttributeName(\"asp-active\")]\n public bool Active { get; set; }\n\n [HtmlAttributeName(\"asp-featured\")]\n public bool Featured { get; set; }\n\n public override void Process(TagHelperContext context, TagHelperOutput output)\n {\n }\n}Второй параметр (TagHelperOutput) позволяет модифицировать исходный тег. Добавим немного логики, получим такой код:
[HtmlTargetElement(\"li\", Attributes = \"asp-active, asp-featured\")]\npublic class ItemTagHelper : TagHelper\n{\n [HtmlAttributeName(\"asp-active\")]\n public bool Active { get; set; }\n\n [HtmlAttributeName(\"asp-featured\")]\n public bool Featured { get; set; }\n\n public override void Process(TagHelperContext context, TagHelperOutput output)\n {\n TagBuilder builder = new TagBuilder(output.TagName);\n\n if (Active)\n builder.AddCssClass(\"active\");\n\n if (Featured)\n builder.AddCssClass(\"featured\");\n\n output.MergeAttributes(builder);\n }\n}Теперь можем поменять код разметки.
\nБыло:
\n@foreach (var item in items) {\n var cl = new List<string>();\n if (item.IsActive)\n cl.Add(\"active\");\n\n if (item.IsFeatured)\n cl.Add(\"featured\");\n\n <li string.empty)=\"\" :=\"\" "\\""=\"\" +=\"\" cl.toarray()=\"\" ",=\"\" string.join("=\"\" "class=\"\\""\" ?=\"\" @(cl.any()=\"\">@item.name\n}</li></string>Стало:
\n@foreach (var item in items) {\n <li asp-featured=\""@item.IsFeatured"\" asp-active=\""@item.IsActive"\">@item.name\n}</li>В зависимости от ситуации, может потребоваться использовать паттерн async/await внутри метода Process. Для этих случаев можно реализовать метод ProcessAsync() вместо Process():
public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output)\n{\n // ...\n}С точки зрения чистоты разметки тег-хелперы выглядят привлекательно. Многие части разметки сразу так и хочется вынести в тег хелперы. Но подойти к этому вопросу стоит осознанно, иначе проект рискует превратиться в кашу из тег-хелперов.
\nЯ бы посоветовал выделить наиболее встречающиеся блоки и обернуть их в тег-хелперы, а специфичные случаи оставить в разметке. Вот хорошие кандидаты на вынесение в тег хелперы:
\nВ ходе виртуальной конференции Microsoft Connect(); // 2015 объявлено об открытии исходных кодов кросс-платформенного редактора кода Visual Studio Code.
\nVS Code существует в редакциях для Windows, Mac OSX и Linux. В его основе лежит идея о простом редакторе кода с минимальным функционалом. Редактор позволяет работать с кодом ASP.NET 5, JavaScript, C++, F#, Powershell, Python и др. Приятно, что как и у старшей версии, в VS Code поддерживается Intellisense.
\nДругой приятной особеннотью VS Code является встроенная поддержка git. Вы можете выполнять простейшие операции с репозитореим не покидая среды разработки.
\nТаким образом, VS Code имеет все шансы занять свое место на рынке. Особенно в том случае, когда всей мощи полной Visual Studio не требуется.
", "tags": [ "Tools", "Visual Studio", "Visual Studio Code", "Open Source" ], "banner_image": "https://blog.zwezdin.com/2015/vs-code-is-open-sourced/d64fe3fd/vs_code-is-open-sourced@cover.jpg" }, { "id": "https://blog.zwezdin.com/2015/tfs-on-premise-to-vs-online/", "url": "https://blog.zwezdin.com/2015/tfs-on-premise-to-vs-online/", "title": "Миграция TFS On-Premise в Visual Studio Online", "date_published": "2015-04-04T13:00:00.000Z", "content_html": "Для команд, использующих собственный TFS перспектива использования сервиса Visual Studio Online выглядит очень заманчиво — не нужно обслуживать сервера, делать бэкапы и т.д. Но сервис Visual Studio Online существует относительно недавно и у многих проекты живут в собственных TFS. В этом случае можно выполнить миграцию данных.
\nДля миграции можно использовать утилиту от компании OpsHub. Пройдем последовательно шаги, необходимые для миграции проекта.
\nProject Collection Service Accounts. Если текущий пользователь не входит в эту группу, нужно его добавить туда (Control Panel → Project → Security → Users).![\"Миграция](\"https://blog.zwezdin.com/2015/tfs-on-premise-to-vs-online/75837e9b/1@2x.png\")
\n\n\n\n\nШаг 1: Утилита OpsHub неспособна мигрировать проект, в котором есть какая-либо кастомизация. Поэтому перед миграцией следует “очистить” исходный проект от каких-либо собственных дополнений.
\nШаг 2: Устанавливаем и запускаем утилиту.
\nШаг 3: Прежде всего следует предоставить информацию об исходном TFS и аккаунте в VS Online. Потребуется URL и имя пользователя.
\nШаг 4: Следующим шагом будет создание миграции. Каждый проект переносится в рамках миграции. Для этого необходимо выбрать кнопку New Migration, указать исходный и целевой сервер и нажать Next.
![\"Миграция](\"https://blog.zwezdin.com/2015/tfs-on-premise-to-vs-online/409b807a/2@2x.png\")
\n\n\n\n\nШаг 5: Следующим шагом следует указать что именно вы хотите мигрировать — содержимое бэклога, исходный код или то и другое.
\n\n\n\n![\"Миграция](\"https://blog.zwezdin.com/2015/tfs-on-premise-to-vs-online/cb64b1f5/3@2x.png\")
\n\n\n\n\nШаг 6: Следующий этап - выбор проекта для миграции. Здесь можно выбрать несколько проектов одновременно, но я бы не рекомендовал этот путь. На этом этапе пустой проект в VS Online с тем же именем уже должен быть создан.
\n\n\n\n![\"Миграция](\"https://blog.zwezdin.com/2015/tfs-on-premise-to-vs-online/58f6d218/4@2x.png\")
\n\n\n\n\nШаг 7: Следующим шагом вам нужно сопоставить пользователей старого TFS и пользователей VS Online. Если у вас большая команда, это, пожалуй, будет самым неприятным этапом. Тем не менее, пропустить этот шаг нельзя.
\n\n\n\n![\"Миграция](\"https://blog.zwezdin.com/2015/tfs-on-premise-to-vs-online/593e3fb7/5@2x.png\")
\n\n\n\n\nШаг 8: После этого утилита миграции проведет полную проверку параметров миграции. Обычно этот процесс занимает несколько минут.
\n\n\n\n![\"Миграция](\"https://blog.zwezdin.com/2015/tfs-on-premise-to-vs-online/485a150d/6@2x.png\")
\n\n\n\n\nШаг 9: Последним шагом вам будет предложено начать миграцию. Соглашаясь с этим вы запускаете процесс миграции. По опыту он достаточно ресурсозатратен и не быстр, поэтому наберитесь терпения.
\nЕсли в процессе что-то пошло не так, то всегда можно удалить проект из VS Online и начать проект заново.
\nК сожалению, этот способ не работает с большими проектами, где большие бэклоги и кодовые базы. В нашем случае утилита просто съедала весь память и CPU и отказывалась работать. В таких, более сложных случаях, придется придумывать какие-то обходные пути. Ну а для небольших проектов этот способ вполне подойдет.
", "tags": [ "Team Foundation Server", "Visual Studio Team System" ], "banner_image": "https://blog.zwezdin.com/2015/tfs-on-premise-to-vs-online/d37f4963/tfs_on-premise-to-vs-online@cover.png" }, { "id": "https://blog.zwezdin.com/2015/application-insights-events-export/", "url": "https://blog.zwezdin.com/2015/application-insights-events-export/", "title": "Экспорт событий Application Insights", "date_published": "2015-03-30T13:00:00.000Z", "content_html": "Application Insights предоставляет очень неплохие инструменты аналитики. Но нельзя исключать ситуаций, когда требуется подключить дополнительные инструменты для анализа различного рода событий. Для этих ситуаций в Application Insights существует функция непрерывного экспорта событий.
\nНа данный момент непрерывный экспорт возможен только в Azure Storage. Поэтому перед началом настройки экспорта нужно создать Azure Storage и контейнер внутри него. После создания хранилища, нужно перейти в панель управления Application Inisights, выбрать раздел Continous Export и нажать кнопку Add:
![\"Экспорт](\"https://blog.zwezdin.com/2015/application-insights-events-export/124edb68/1@2x.png\")
\n\n\n\n\nПосле выбора хранилища, необходимо выбрать тип событий, которые должны экспортироваться:
\n\n\n\n![\"Экспорт](\"https://blog.zwezdin.com/2015/application-insights-events-export/094a8d10/2@2x.png\")
\n\n\n\n\nНа этом настройка непрерывного экспорта завершена. С этого момента Application Insights будет экспортировать выбранный тип событий в указанное хранилище. Данные будут сохраняться в формате JSON. Пример экспортированного файла:
\n\n\n\n![\"Экспорт](\"https://blog.zwezdin.com/2015/application-insights-events-export/78c00a5c/3@2x.png\")
",
"tags": [
"ASP.NET",
"Application Insights"
],
"banner_image": "https://blog.zwezdin.com/2015/application-insights-events-export/f939ddb2/application_insights-events-export@cover.png"
},
{
"id": "https://blog.zwezdin.com/2015/application-insights-events-tracking/",
"url": "https://blog.zwezdin.com/2015/application-insights-events-tracking/",
"title": "Отслеживание событий при помощи сервиса Application Insights",
"date_published": "2015-03-18T13:00:00.000Z",
"content_html": "Одна из полезных возможностей Application Insights — это отслеживание событий, которые происходят в приложение во время работы. На основании этих данных можно сделать выводы об использовании приложения, какие фичи пользователи используют, а какие нет. Отдельно можно провести анализ ошибок, возникающих при работе.
\nПользовательские события позволяют определить ключевые точки приложения и анализировать статистику их использования. Например, в интернет-магазине можно добавить событие добавления в корзину. В системе документооборота такими событиями могут быть создание и изменение документа. Позже, по этим событиям можно получить статистику по времени.
\nДля работы с пользовательскими событиями, кроме подключения AI к проекту, требуется добавить немного кода в приложение. Для взаимодействия с сервисом используется объект TelemetryClient. Отправка события регистрация пользователя в приложении может выглядеть так:
TelemetryClient telemetry = new TelemetryClient();\ntelemetry.TrackEvent(\"UserSignup\");Если вместе с событием требуется учитывать какие-то дополнительные данные, то в метод TrackEvent можно передать дополнительные параметры:
TelemetryClient telemetry = new TelemetryClient();\ntelemetry.TrackEvent(\"UserSignup\",new Dictionary<string, string>\n{\n {\"Role\", \"Observer\"},\n {\"Company\", \"A&B\"}\n});Аналитика по событиям выглядит следующим образом:
\n\n\n\n![\"Отслеживание](\"https://blog.zwezdin.com/2015/application-insights-events-tracking/d6285cac/1@2x.png\")
\n\n\n\n\nМожно получить дополнительные проекции данных, используя фильтры:
\n\n\n\n![\"Отслеживание](\"https://blog.zwezdin.com/2015/application-insights-events-tracking/da7ae2e9/2@2x.png\")
\n\n\n\n\nКлик по каждому событию также покажет подробную информацию по выбранному событию.
\nКак и в случае с анализом работоспособности приложения, здесь можно настроить уведомления, которые будут отправляться при достижении пороговых значений. Например, если количество добавлений в корзину за день меньше, чем какое-то выбранное значение, то вы получите уведомление по email.
\nДругой замечательной возможностью AI является возможность хранения и обработки логов. Безусловно многие хранят логи на своих серверах в файлах специального формата. Но я думаю не ошибусь, если скажу, что процесс чтения и анализа лог-файлов не доставляет особого удовольствия. Все потому, что в большинстве случаев это простые текстовые файлы, содержащие огромный объем данных.
\nApplication Insights ведет журнал внутренних событий - HTTP-запрос, просмотр страницы и т.п. При возникновении нестандартных ситуаций в приложении можно также отправить эту информацию в AI. Для этого используется тот же самый объект TelemetryClient:
try\n{\n // ...\n}\ncatch (Exception ex)\n{\n TelemetryClient telemetry =\n new TelemetryClient();\n telemetry.TrackException(ex);\n\n throw;\n}Информация об исключении передается в метод TrackException и далее отправляется на сервис. Есть перегруженная версия этого метода, которая вместе с исключение позволяет отправить на сервер дополнительные данные (свойства и метрики, критичность исключения и т.д.):
try\n{\n // ...\n}\ncatch (Exception ex)\n{\n TelemetryClient telemetry = new TelemetryClient();\n telemetry.TrackException(new ExceptionTelemetry(ex)\n {\n Properties =\n {\n {\"Role\", \"Observer\"},\n {\"Company\", \"A&B\"}\n },\n Metrics =\n {\n {\"Balance\", 150},\n },\n SeverityLevel = SeverityLevel.Critical\n });\n\n throw;\n}Позже по этим данным можно строить дополнительные проекции данных и подвергать их анализу.
\nЕсли в приложении уже присутствует система ведения логов, то можно подключить AI к ней. На данный момент существуют адаптеры для:
\n\nОтчет по содержимому логов выглядит так:
\n\n\n\n![\"Отслеживание](\"https://blog.zwezdin.com/2015/application-insights-events-tracking/77fb2a66/3@2x.png\")
\n\n\n\n\nВ верхней части показывается общая статистика и тренды. По каждому событию можно кликнуть и получить полную информацию. Что удобно, AI умеет систематизировать события и по выбранному событию отобразить запросы, так или иначе связанные с этим событием.
\nТаким образом, данные аспекты работы приложения всегда остаются под вашим контролем.
", "tags": [ "ASP.NET", "Application Insights" ], "banner_image": "https://blog.zwezdin.com/2015/application-insights-events-tracking/34c438fb/application_insights-events-tracking@cover.png" }, { "id": "https://blog.zwezdin.com/2015/application-insights-performance/", "url": "https://blog.zwezdin.com/2015/application-insights-performance/", "title": "Измерение производительности и доступности приложения при помощи Application Insights", "date_published": "2015-03-12T13:00:00.000Z", "content_html": "В предыдущем посте было описано что такое Application Insights и какие задачи решает эта платформа. На этот раз взглянем на Application Insights со стороны мониторинга работоспособности приложения.
\nБудем считать, что приложение работает если: 1) оно корректно отвечает на ключевые HTTP-запросы; 2) делает это за приемлемое время. Т.е. нам нужно убедиться отвечает ли приложение вообще, и если да, то насколько быстро отрабатывает запросы. Причем этот мониторинг должен выполняться на постоянной основе, через определенные интервалы.
\nОсновой для тестирования доступности и производительности явлются веб-тесты. Веб-тест может быть простым (простой HTTP-запрос по указанному адресу и проверка ответа) и записанным по сценарию (зайти на страницу, перейти на другую, ввести данные и т.п.). Записанные веб-тесты — это Web Performance Test, который можно создать или записать в Visual Studio. В результате получается файл .webtest, который нужно будет загрузить в Application Insights.
Для создания веб-теста в AI, нужно выбрать раздел Availability и нажать кнопку Add web test.
![\"Измерение](\"https://blog.zwezdin.com/2015/application-insights-performance/95933078/1@2x.png\")
\n\n\n\n\nПри создании теста следует указать тип теста, задать нужные параметры и указать с каких локаций он будет запускаться.
\nСразу после создания сервис запустит эти тесты. На общей панели управления будет отображаться сводка о наиболее медленных запросах:
\n\n\n\n![\"Измерение](\"https://blog.zwezdin.com/2015/application-insights-performance/91670f5e/2@2x.png\")
\n\n\n\n\nКлик по этой панели откроет раздел, где можно посмотреть детальную аналитику по каждому запросу, времени выполнения и трендам:
\n\n\n\n![\"Измерение](\"https://blog.zwezdin.com/2015/application-insights-performance/4d55554d/3@2x.png\")
\n\n\n\n\nКликнув по конкретному адресу можно посмотреть детали конкретного запроса.
\nСкорее всего, для своего приложения вы имеете ориентиры насколько быстро оно должно отвечать на HTTP-запросы. Эти пороговые значения можно указать при настройке веб-теста. В таком случае при превышении этого порога вы получите уведомление на email. Уведомления так же будут отправляться, если веб-тест завершился неудачей (например, страница по нужному адресу не открылась).
\nОтчет под доступности приложения также очень наглядно показывает состояние приложения:
\n\n\n\n![\"Измерение](\"https://blog.zwezdin.com/2015/application-insights-performance/aae57d70/4@2x.png\")
\n\n\n\n\nПодобная аналитика с одной стороны очень проста для восприятия, а с другой является очень мощным инструментом, дающим наглядную картину того, насколько успешно работает приложение.
", "tags": [ "ASP.NET", "Application Insights" ], "banner_image": "https://blog.zwezdin.com/2015/application-insights-performance/0637562b/application_insights-performance@cover.png" }, { "id": "https://blog.zwezdin.com/2015/application-insights-introduction/", "url": "https://blog.zwezdin.com/2015/application-insights-introduction/", "title": "Что такое Application Insights и как этот сервис может помочь разработчику", "date_published": "2015-03-01T13:00:00.000Z", "content_html": "Мы, разработчики, очень заботимся о коде, пишем тесты, проводим рефакторинг. Но когда дело касается переноса приложения на реальный сервер, не очень то и заботимся об этом - перенесли, проверили, что работает и забыли. Однако именно в этот момент могут появиться проблемы самого разного характера. Сервисы мониторинга позволяют заполнить этот пробел в жизненном цикле приложений и осуществлять постоянный контроль за работоспособностью приложения. Одним из таких сервисов является Application Insights.
\nСервис Application Insights впервые появился как часть Visual Studio Online. На данный момент этот сервис является частью облачной платформы Azure со всеми вытекающими последствиями. Сервис позволяет мониторить показатели используемости, доступности и производительности приложения. Но обо все по-порядку.
\nApplication Insights работает с приложениями ASP.NET. Приложения Windows Phone и Windows Store также можно мониторить. Совсем недавно была заявлена поддержка Java. Кроме того, Application Insights можно подключить к приложениям на платформе Node.js, PHP, Python, Ruby, Android и iOS, SDK для каждой из этих платформ находятся в открытом доступе на github.
\nДля подключения Application Insights к проекту потребуется Visual Studio 2013 Update 3 или новее. Для этого заходим на портал Azure и создаем новый сервис Application Insights. После Application Insights можно подключать к проекту. Для этого достаточно правой кнопкой кликнуть на проекте и выбрать пункт меню Add Application Insights Telemetry:
![\"Что](\"https://blog.zwezdin.com/2015/application-insights-introduction/e9c51815/1@2x.png\")
\n\n\n\n\nПосле этого будет предложено войти на портал Azure и выбрать сервис, который будет связан с этим приложением. После этого в проект будет добавлен файл ApplicationInsights.config (содержащий идентификатор сервиса AI в облаке). Кроме того, в проект устанавливаются нужные пакеты из Nuget и в web.config добавляются Http-моудли для отслеживания активности. Альтернативный способ - это воспользоваться специальной утилитой на сервере, тогда код проекта изменять не потребуется. Всё, что делает эта утилита - добавляет нужные библиотеки и меняет конфигурационный файл. Так что в некотором смысле оба способа идентичны.
Теперь можно публиковать и запускать приложение. Данные начнут собираться и отправляться на сервис. Через несколько минут после этого можно начать смотреть отчеты.
\nКоличество пользователей, сессий, запросов, статистика по странам:
\n\n\n\n![\"Что](\"https://blog.zwezdin.com/2015/application-insights-introduction/e6cf4980/2@2x.png\")
\n\n\n\n\nОтслеживание медленных запросов:
\n\n\n\n![\"Что](\"https://blog.zwezdin.com/2015/application-insights-introduction/b80b3308/3@2x.png\")
\n\n\n\n\nОтслеживание исключений:
\n\n\n\n![\"Что](\"https://blog.zwezdin.com/2015/application-insights-introduction/b3745496/4@2x.png\")
",
"tags": [
"ASP.NET",
"Application Insights"
],
"banner_image": "https://blog.zwezdin.com/2015/application-insights-introduction/27f4260b/application_insights-introduction@cover.png"
},
{
"id": "https://blog.zwezdin.com/2014/hangfire/",
"url": "https://blog.zwezdin.com/2014/hangfire/",
"title": "Выполнение кода в фоне в ASP.NET при помощи Hangfire",
"date_published": "2014-12-21T13:00:00.000Z",
"content_html": "Веб-приложения - это не только, обработка HTTP-запросов. Часто приложению приходится выполнять какую-то работу в фоне - например, списывать деньги со счета по расписанию или выполнять отправку email-сообщения, не задерживая при этом ответ пользователю.
\nРешают эту задачу все по-разному - кто-то создает свою службу Windows, кто-то запускает код по расписанию с помощью планировщика Windows. Есть ещё один прекрасный способ - библиотека Hangfire.
\nВ основе идеи Hangfire лежит ключевое “fire-and-forget”, что означает запустить код на выполнение и забыть - далее он выполнится в фоне без вашего участия. При этом вам не потребуются дополнительные инфраструктурные вмешательства (такие как Windows Service), что существенно упростит процесс развертывания. Hangfire подключается к приложению путем установки пакета из Nuget.
\nДля подключения Hangfire к приложению нужно установить пакет Hangfire из Nuget:
\nInstall-Package HangFireДанный пакет содержит базовую инфраструктуру Hangfire и хранилище для SQL Server. Hangfire использует внешнее хранилище данных для очередей для того, чтобы фоновые задачи не удалялись при перезапуске приложения. По умолчанию в качестве хранилища используется SQL Server, в платной Pro-версии есть возможность работать с Redis. Также я сделал свой провайдер для Mongo.
\nДля запуска Hangfire используется инфраструктура OWIN (отличное решение, с учетом задела на будущее), для конфигурации нужно выполнить метод UseHangfire:
public void Configuration(IAppBuilder app)\n{\n app.UseHangfire(config =>\n {\n config.UseSqlServerStorage(\"<connection string or its name>\");\n config.UseServer();\n });\n}Метод UseHangfire принимает в качестве аргумента метод для конфигурирования Hangfire. Здесь нужно обязательно использовать какой-либо из типов источников данных. Провайдер для SQL Server автоматически создаст нужные таблице в вашей базе данных, поэтому дополнительных действий тут не требуется - нужно только указать строку подключения SQL Server:
public void Configuration(IAppBuilder app)\n{\n app.UseHangfire(config =>\n {\n config.UseSqlServerStorage(\n @\"Data Source=.\\SQLEXPRESS;Initial Catalog=TestApplication;Integrated Security=True\");\n config.UseServer();\n });\n}Необходимые таблицы будут созданы при первом запуске приложения:
\n\n\n\n![\"Выполнение](\"https://blog.zwezdin.com/2014/hangfire/bb3dc1e0/1@2x.png\")
\n\n\n\n\nАналогично работают провайдеры для Redis и Mongo — нужные коллекции создаются автоматически.
\nЭтого достаточно для того, чтобы Hangfire заработал. Можно запустить приложение и вам будет доступен Dashboard от Hangifre по адресу /hangfire. Там содержаться все задачи — выполненные, запланированные, ошибочные и т.д.
![\"Выполнение](\"https://blog.zwezdin.com/2014/hangfire/e6379da8/2@2x.png\")
\n\n\n\n\nЕсли требуется закрыть паролем этот Dashboard, то существует отдельный пакет - Hangfire.Dashboard.Authorization, который поддерживает встроенную аутентификацию ASP.NET, а также Basic Authentication. Не забывайте настроить HTTPS для вашего веб-приложения.
Такой конфигурации достаточно, чтобы потестировать Hangfire, но для продакшн-среды нужны некоторые дополнительные действия. Что именно нужно сделать зависит от типа хостинга вашего приложения, но в целом идея заключается в том, чтобы убедиться, что ASP.NET приложение не переходит в спящий режим. Подробнее это описано в официальной документации.
\nHangfire имеет возможность запуска разных типов задач:
\nПри запуске задачи в Hangfire она помещается в очередь (в хранилище появляется соответствующая запись) и далее выполняется в фоне.
\nДля примера, создадим приложение, отправляющее email-ы. Почему это нужно делать в фоне? Дело в том, что скорость отправки сообщения зависит от конкретного SMTP-сервера. Эта задержка увеличивается, если отправлять несколько сообщений. Например, у меня были случаи, когда по запросу от пользователя нужно было рассылать более 10 сообщений - в этом случае задержка становится ощутимой. В случае с Hangfire мы просто ставим задачи по отправке email-сообщений в очередь и больше не задерживаем пользователя. Поэтому предпочтительнее обрабатывать такие задачи именно в фоне.
\nСоздадим простейший сервис для отправки сообщения:
\npublic static class EmailService\n{\n public static void Send(string from, string to, string subject, string body)\n {\n using (var smtp = new SmtpClient())\n {\n // ...\n\n smtp.Send(from, to, subject, body);\n }\n }\n}Чтобы поставить задачу на отправку сообщения в очередь следует воспользоваться объектом BackgroundJob:
public ActionResult Send()\n{\n BackgroundJob.Enqueue(() =>\n EmailService.Send(\"from@email.com\", \"to@email.com\", \"Subject\", \"Text\"));\n\n return View();\n}Как только задачи будут поставлены в очередь, это будет видно в Hangfire Dashboard:
\n\n\n\n![\"Выполнение](\"https://blog.zwezdin.com/2014/hangfire/0768dc88/3@2x.png\")
\n\n\n\n\nЗдесь же можно отслеживать успешные и неудачные попытки выполнения заданий, отслеживать задания по расписанию и визульно видеть объем задач, выполняемых в фоне.
", "tags": [ "ASP.NET" ], "banner_image": "https://blog.zwezdin.com/2014/hangfire/7b73235e/hangfire@cover.png" }, { "id": "https://blog.zwezdin.com/2014/deploy-website-with-webdeploy/", "url": "https://blog.zwezdin.com/2014/deploy-website-with-webdeploy/", "title": "Настраиваем WebDeploy для развертывания приложений ASP.NET", "date_published": "2014-10-07T12:00:00.000Z", "content_html": "Рано или поздно возникает необходимость развертывания приложения на сервер. Исторически многие делают это при помощи FTP/SFTP. Однако, этот способ развертывания нельзя назвать удобным. Мало того, что развертывание в этом случае занимает много времени, оно к тому же не является атомарным. Как же быть? Правильный ответ - WebDeploy.
\nWebDeploy позволяет собирать пакеты и атомарно развертывать их на сервере - из Visual Studio или используя автоматизированные скрипты. Давайте последовательно пройдем шаги по настройке WebDeploy на сервере.
\nДля установки потребуется скачать установочный пакет и запустить его на сервере. Альтернативным способом является установка Web Deploy через Web Platform Installer. В последнем случае для установки нужно выбрать пакет Web Deploy 3.5.
![\"Настраиваем](\"https://blog.zwezdin.com/2014/deploy-website-with-webdeploy/42a321bb/1@2x.png\")
\n\n\n\n\nПосле успешной установки Web Deploy в консолии IIS должны появится разделы Management Service и Management Service Delegation. Для корректной работы Web Deploy в разделе Management Service следует разрешить удаленные подключения:
![\"Настраиваем](\"https://blog.zwezdin.com/2014/deploy-website-with-webdeploy/662eecdf/2@2x.png\")
\n\n\n\n\nЗдесь же можно указать SSL-сертификат, если у вас такой имеется.
\nЕсли вы все сделали правильно, то в контекстном меню каждого сайта должен появиться пункт меню Deploy:
![\"Настраиваем](\"https://blog.zwezdin.com/2014/deploy-website-with-webdeploy/601c8f7e/3@2x.png\")
\n\n\n\n\nНеобходимо выбрать пункт меню Configure Web Deploy Publishing, чтобы разрешить публикацию для этого сайта, указать имя пользователя, от имени которого будут публиковаться пакеты, URL и нажать кнопку Setup.
![\"Настраиваем](\"https://blog.zwezdin.com/2014/deploy-website-with-webdeploy/f7bc75af/4@2x.png\")
\n\n\n\n\nВнимание: Важно, чтобы пользователь, которого вы указываете при настройке Web Deploy имел права на запись в папку веб-сайта.
\nТеперь всё готово для публикации приложения.
\nПубликовать приложение можно двумя способами — напрямую из Visual Studio и используя автоматизированные билд-скрипты.
\nДля публикации из Visual Studio следует выбрать веб-сайт в Solution Explorer и в контекстом меню выбрать пункт Publish. В появившемся диалоге нужно заполнить требуемые поля и запустить публикацию:
![\"Настраиваем](\"https://blog.zwezdin.com/2014/deploy-website-with-webdeploy/8efc7778/5@2x.png\")
\n\n\n\n\nДля публикации через msbuild-скрипт, можно использовать следующий подход: сначала мы собираем пакет для публикации (который к тому же будет является артефактом сборки), а затем публикуем его.
\nПодготовка пакета:
\n<Target Name=\"PrepareWebDeployPackage\">\n <MSBuild Projects=\"WebApplication.csproj\"\n Targets=\"Package\"\n Properties=\"PackageLocation=WebApplicationPackage.zip\"/>\n</Target>Публикация пакета:
\n<Target Name=\"PublishWebDeployPackage\">\n <Exec Command=\"WebDeploy\\msdeploy.exe -source:package='WebApplicationPackage.zip' -dest:auto,computerName='..',userName='..',password='..',authtype='NTLM',includeAcls='False' -verb:sync -allowuntrusted -setParam:\"IIS Web Application Name\"=\"WebApp1\"\"/>\n</Target>Как видно, при публикации требуется указать адрес для публикации, имя пользователя и пароль, а также имя сайта на сервере.
\nПо опыту могу сказать, что при настройке публикации могут возникать проблемы. Если вы убедились, что файрвол не блокирует ваши подключения и сервис WebDeploy установлен корректно, то можно включить отслеживание запросов и понять в чем причина.
", "tags": [ "ASP.NET", "DevOps" ], "banner_image": "https://blog.zwezdin.com/2014/deploy-website-with-webdeploy/6547a72c/deploy_website-with-webdeploy@cover.png" }, { "id": "https://blog.zwezdin.com/2014/fronttalks-2014/", "url": "https://blog.zwezdin.com/2014/fronttalks-2014/", "title": "FrontTalks 2014 в Екатеринбурге (фотоотчет)", "date_published": "2014-09-22T12:00:00.000Z", "content_html": "19 сентября 2014 г. в Екатеринбурге прошла конференция FrontTalks 2014. Если не считать препати UWDC’2014, то это первая конференция FrontTalks, которую мне удалось посетить. Мероприятие проходило в бизнес-центре “Палладиум”, в самом центре Екатеринбурга.
\nFrontTalks посвящено фронтенд разработке во всех её проявлениях. Программа была запланирована на весь день и содержала 9 докладов. Докладчики приехали из Москвы, Новосибирска, Санкт-Петербурга, Екатеринбурга, Челябинск, Минска, Осло и Симферополя. География участников включала Екатеринбург, Челябинск, Пермь, Ижевск и, возможно, какие-то другие города. Общее количество участников – что-то около 240 человек.
\nМы приехали к началу регистрации и все уже были на месте, полным ходом шло приготовление. Место проведения мне очень понравилось – просторный зал и хорошая слышимость докладчика. Кроме того, благодаря форме зала создавалась какая-то особая атмосфера, в которой чувствуешь себя ещё более комфортно.
\n\n\n\n![\"Общий](\"https://blog.zwezdin.com/2014/fronttalks-2014/d5ea4373/1@2x.jpg\")
Доклады шли в один поток, с 5-10 минутными перерывами и одним большим перерывом на обед. В перерывах народ активно общался с докладчиками и между собой. Большим плюсом было наличие кофе и воды, которые были доступны буквально в соседнем зале. Мелочь, а приятно.
\nПоскольку каждый доклад был интересен по-своему, пробегусь вкратце по каждому из них. Открыл мероприятие Олег Мохов, который является главным организатором и движущей силой конференции FrontTalks. Приветствие было не очень долгим, после чего мы непосредственно перешли к докладам.
\n\n\n\n![\"Олег](\"https://blog.zwezdin.com/2014/fronttalks-2014/d284b419/2@2x.jpg\")
Первый доклад представил Роман Сальников из 2GIS, который был полностью посвящен инструментам разработчика в Chrome. Весь доклад прошел под девизом “Вы можете и дальше мучиться, а можете потратить немного времени и намного упростить себе жизнь”. Я полностью согласен с этим утверждением. Очень часто бывает так, что время потраченное на более глубокое изучение инструментов потом окупится в процессе работы. Роман показал несколько приемов как можно отлаживать код в Chrome Dev Tools – начиная с работы с консолью, заканчивая профилированием CPU и GPU.
\n\n\n\n![\"Роман](\"https://blog.zwezdin.com/2014/fronttalks-2014/1a3b9acd/3@2x.jpg\")
Следующим выступил Алексей Иванов из JetStyle, он рассказал о пре- и пост-процессорах CSS. Основная мысль заключалась в том, что препроцессоры – это отличная штука. Но некоторые задачи с препроцессорами решать неудобно. Признаюсь, в самом начале я достаточно скептически отнесся к этому утверждению. Но Алексей очень хорошо показал, что это действительно может быть полезно и да, иногда это удобнее препроцессоров. В докладе были упомянуты SASS, LESS и Stylus, после чего Алексей рассказал историю создания Rework и postcss. А ещё у Алексея отличное чувство юмора – “Что бы ни писали программисты на руби, у них в итоге всё равно получается руби“ – это шутка про создание SASS.
\n\n\n\n![\"Алексей](\"https://blog.zwezdin.com/2014/fronttalks-2014/1b8c567c/4@2x.jpg\")
А вот следующий доклад Алексея Бахирева впечатлил меньше остальных. Темой здесь была разработка для мобильных устройств, для разной аудитории и форм-факторов. Были затронуты такие штуки как j2me, андроид и даже Smart TV. Алексей рассказывал о разработке в разрезе своих задач, но некоторые советы мне показались весьма сомнительными. Собственно, это подтвердили и другие участники, задавая свои вопросы в конце доклада.
\n\n\n\n![\"Алексей](\"https://blog.zwezdin.com/2014/fronttalks-2014/1fa3770c/5@2x.jpg\")
Программа мероприятия продолжилась после обеда и на этот раз выступил Роман Дворнов из Ostrovok.ru. Тема доклада Романа – “Баба-Яга против!”. Доклад получился очень веселый и позитивный. Но проблематика, которая здесь обсуждалась довольно серьезная и затрагивает она вопросы внедрения новых технологий на фронтенде, обновление стандартов, куда все это ведет и чем это грозит. После выступления Романа, другие докладчики ещё не раз ссылались на Бабу Ягу из этого доклада. Да, всех задело за живое :-)
\n\n\n\n![\"Роман](\"https://blog.zwezdin.com/2014/fronttalks-2014/5266542b/6@2x.jpg\")
Следующим на сцене появился Арсений Форштретер, который рассказал о применении flexbox при разработке современных сайтов. В самом начале Арсений показал как это вообще работает (для тех, кто не в курсе), а потом перешел к тому, насколько может упроститься код в нестандартных сценариях. Докладчик попытался убедить всех, что flexbox можно использовать уже сегодня и что оно работает во многих современных браузерах (а там где не работает показал как сделать фолбеки). Честно говоря, я думаю, что применять flexbox пока ещё рано и нужно немного подождать.
\n\n\n\n![\"Арсений](\"https://blog.zwezdin.com/2014/fronttalks-2014/235b6900/7@2x.jpg\")
Продолжил серию выступлений Володя Кузнецов с темой про SVG. Тема очень актуальная с условиях когда диапазон размеров экранов очень велик. Как и ожидалось, SVG до сих пор имеет ряд проблем с совместимостью, но Владимир показал различные уловки, как эти проблемы можно обойти. Также были продемонстрированы возможности анимирования, как всей сцены, так и отдельных её частей. Доклад получился интересный и полезный с практической точки зрения. Думаю, многие возьмут на вооружение то, о чем говорилось в докладе.
\n\n\n\n![\"Владимир](\"https://blog.zwezdin.com/2014/fronttalks-2014/c7362f74/8@2x.jpg\")
Тему SVG продолжил развивать Дмитрий Дудин в своем докладе “Как сделать Инстаграм в браузере”. Доклад был про то, как использовать эффекты и фильтры для фото на клиенте. Было предложено несколько способов, но остановился Дмитрий именно на SVG-фильтрах. Доклад получился очень живой, полный различных примеров и сопровождающийся полезными ссылками на библиотеки, которые позволяют упростить жизнь при работе с изображениями.
\n\n\n\n![\"Дмитрий](\"https://blog.zwezdin.com/2014/fronttalks-2014/5268f4de/9@2x.jpg\")
Отличный доклад подготовил Вадим Макеев, человек очень известный в мире веб-технологий. На этот раз Вадим рассказывал об использовании изображений на страницах и рассказал почему тег <img> уже не удовлетворяет современным требованиям. Была показана хронология как это развивалось и в завершение мы увидели отличную демонстрацию того, как в скором будущем мы будем вставлять изображения на страницу. Основная идея в этом направлении – это адаптация изображения под тип устройства и загрузка с сервера только той версии картинки, которая наиболее оптимально подходит под текущие условия. Тема очень интересная, но нужно, чтобы её поддержали все браузеры. Тем не менее, то, что мы увидели очень впечатляет и надеюсь скоро мы сможем этим пользоваться.
![\"Вадим](\"https://blog.zwezdin.com/2014/fronttalks-2014/28f8e327/10@2x.jpg\")
<picture> — Фото: Сергей ЗвездинПоследним в программе стоял доклад от Вадима Макишвили с загадочным названием “36”. Мне будет очень трудно передать все, о чем Вадим говорил в ходе своего повествования. Если говорить в целом, то доклад был о том, что испытывает человек, который перешагнул возраст “36”. О том, что это очень сложный период, и что в этот момент можно наломать дров. Доклад был воспринят на ура и все слушали, затаив дыхание. Эта тема заставляет задуматься над тем, что ты делаешь и зачем это делаешь, а также о том, что будет завтра и что с этим делать.
\n\n\n\n![\"Вадим](\"https://blog.zwezdin.com/2014/fronttalks-2014/c792b07d/11@2x.jpg\")
![\"Вадим](\"https://blog.zwezdin.com/2014/fronttalks-2014/97d1f5a3/12@2x.jpg\")
Всегда, оказываясь на новом мероприятии, я стараюсь ответить на вопрос “поеду ли я сюда еще раз?“. Что касается FrontTalks, то мне мероприятие очень понравилось – и по формату, и по содержательной части. Так что в случае с FrontTalks – однозначно, приеду еще.
\nСпасибо организаторам и докладчикам за интересный день!
", "tags": [ "Мероприятия", "FrontTalks" ], "banner_image": "https://blog.zwezdin.com/2014/fronttalks-2014/2c7f8a02/fronttalks_2014@cover.jpg" }, { "id": "https://blog.zwezdin.com/2014/webapi-client/", "url": "https://blog.zwezdin.com/2014/webapi-client/", "title": "Клиент для WebAPI", "date_published": "2014-09-22T12:00:00.000Z", "content_html": "Уже много сказано о том, как создавать свои API на основе ASP.NET WebAPI и существенно меньше о том, как работать с этими сервисами со стороны клиента. Это и понятно, ведь часто потребителями этих сервисов выступает клиентский JavaScript, который умеет работать с JSON “из коробки”. Тем не менее, случается и так, что клиентом должно быть .NET-приложение.
\nУдивительно, но несколько раз я встречал в коде, когда .NET-приложение взаимодействует с сервером при помощи HttpClient, а потом пытается вручную разбирать JSON/XML, пытаться проверять тип данных и т.п. Такой подход ведет к усложнению коду и ошибкам. Вместо этого можно воспользоваться уже готовой библиотекой, в которой это уже реализовано.
\nСоздаем приложение, добавляем HttpClient, загружаем содержимое ответа с сервера:
using (var http = new HttpClient())\n{\n var result = await http.GetAsync(new Uri(\"http://localhost:40139/api/users/get\"));\n result.EnsureSuccessStatusCode();\n\n // ...\n}Устанавливаем Microsoft.AspNet.WebApi.Client:
Install-Package Microsoft.AspNet.WebApi.ClientДобавляем объект, описывающий сущность, возвращаемую сервером:
\npublic class User\n{\n public string Name { get; set; }\n public string Email { get; set; }\n}После получения ответа с сервера, распакуем его непосредственно в эти объекты:
\nusing (var http = new HttpClient())\n{\n var result = await http.GetAsync(new Uri(\"http://localhost:40139/api/users/get\"));\n result.EnsureSuccessStatusCode();\n\n var users = await result.Content.ReadAsAsync<IEnumerable<User>>();\n\n foreach (var user in users)\n {\n // ...\n }\n}Как видно, мы не выполняем никаких действий по парсингу и преобразованию ответа.
\nЕсли предполагается, что сервер может вернуть результат в разных форматах, можно определить список форматировщиков, которые будут использоваться при распозновании ответа:
\nvar users = await result.Content.ReadAsAsync<IEnumerable<User>>(\n new MediaTypeFormatter[]\n {\n new JsonMediaTypeFormatter(),\n new XmlMediaTypeFormatter()\n });Можно не только получать данные с сервера, но и отправлять их обратно:
\nusing (var http = new HttpClient())\n{\n var result = await http.PostAsync(\n \"http://localhost:40139/api/users/create\",\n new User { Name = \"User1\", Email = \"user1@mail.com\" },\n new JsonMediaTypeFormatter());\n\n result.EnsureSuccessStatusCode();\n}Явно указывать используемый форматировщик необязательно. Вместо этого можно использовать перегруженные методы PostAs<>, например PostAsJsonAsync:
using (var http = new HttpClient())\n{\n var result = await http.PostAsJsonAsync(\n \"http://localhost:40139/api/users/create\",\n new User { Name = \"User1\", Email = \"user1@mail.com\" });\n\n result.EnsureSuccessStatusCode();\n}ASP.NET WebAPI имеет две модели работы с контентом, который отдается клиенту - управлять непосредственно содержимым ответа или возвращать в качестве результата CLR-объект и предоставить WebAPI возможность самостоятельно решить в каком виде отдавать эти данные. Последний вариант на мой взгляд предпочтительнее, поскольку оставляет инфраструктурные вопросы платформе и позволяет думать только о логике. В таком случае встает вопрос о том, как WebAPI решает в каком виде эти данные уйдут на клиент, а также как на это поведение повлиять.
\nВозьмем для примера тривиальный WebAPI контроллер:
\npublic class UsersController : ApiController\n{\n [HttpGet]\n public IEnumerable<User> Get()\n {\n return new[]\n {\n new User {Name = \"User1\", Email = \"user1@email.com\"},\n new User {Name = \"User2\", Email = \"user2@email.com\"},\n new User {Name = \"User3\", Email = \"user3@email.com\"},\n new User {Name = \"User4\", Email = \"user4@email.com\"},\n };\n }\n}В качестве результата действие Get() отдает коллекцию объектов. В процессе обработки запроса WebAPI предстоит решить вопрос в каком виде отдавать эти данные - JSON, XML или каком-либо ещё? Для этого в инфраструктуре WebAPI имеется механизм, который называется Media Formatters. Задача этих сервисов заключается в форматировании объектов в нужном виде. Процесс обработки запроса выглядит следующим образом:
Accept.Чтобы убедиться в корректности этой схемы, можно запустить приложение и отправить ему пару HTTP-запросов:
\nЗапрос:
\nGET http://localhost:40139/api/users/get HTTP/1.1\nUser-Agent: Fiddler\nHost: localhost:40139\nAccept: application/jsonОтвет:
\nHTTP/1.1 200 OK\nContent-Type: application/json; charset=utf-8\nServer: Microsoft-IIS/8.0\nContent-Length: 173\n\n[{\"Name\":\"User1\",\"Email\":\"user1@email.com\"},{\"Name\":\"User2\", ...Второй вариант:
\nЗапрос:
\nGET http://localhost:40139/api/users/get HTTP/1.1\nUser-Agent: Fiddler\nHost: localhost:40139\nAccept: application/xmlОтвет:
\nHTTP/1.1 200 OK\nContent-Type: application/xml; charset=utf-8\nServer: Microsoft-IIS/8.0\nContent-Length: 400\n\n<ArrayOfUser ...><User><Email>user1@email.com</Email><Name>User1...Как видно, WebAPI по-разному формирует ответ для разных значений HTTP-заголовка Accept.
\nЭто поведение можно изменить и добавить свой форматировщик. Например, сделаем форматировщик, отдающий результат в текстовом формате (text/plain).
Нам потребуется объект, унаследованный от MediaTypeFormatter. Нужно также указать тип ответа и тип объектов, с которыми может работать форматировщик:
public class TextFormatter : BufferedMediaTypeFormatter\n{\n public TextFormatter()\n {\n SupportedMediaTypes.Add(new MediaTypeHeaderValue(\"text/plain\"));\n }\n\n public override bool CanReadType(Type type)\n {\n return false;\n }\n\n public override bool CanWriteType(Type type)\n {\n return type == typeof(IEnumerable<User>);\n }Для формирования результата следует переопределить метод WriteToStream(), который имеет доступ к исходному объекту (который получен из контроллера), текущему HTTP-запросу, а также потоку для генерации результата:
public class TextFormatter : BufferedMediaTypeFormatter\n{\n // ...\n\n public override void WriteToStream(Type type, object value, Stream writeStream, HttpContent content)\n {\n var items = (IEnumerable<User>)value;\n\n using (var writer = new StreamWriter(writeStream))\n {\n foreach (var item in items)\n {\n writer.WriteLine(\"Name: {0}, Email: {1}\", item.Name, item.Email);\n }\n }\n }Наконец, нужно зарегистрировать этот форматировщик в инфраструктуре WebAPI:
\npublic static class WebApiConfig\n{\n public static void Register(HttpConfiguration config)\n {\n config.Formatters.Add(new TextFormatter());Теперь все запросы, заголовок Accept которых содержит text/plain, а результат работы контроллера возвращает IEnumerable<User>, будут обрабатываться этим объектом. Это легко проверить, выполнив ещё один HTTP-запрос:
Запрос:
\nGET http://localhost:40139/api/users/get HTTP/1.1\nUser-Agent: Fiddler\nHost: localhost:40139\nAccept: text/plainОтвет:
\nHTTP/1.1 200 OK\nContent-Type: text/plain\nServer: Microsoft-IIS/8.0\nContent-Length: 148\n\nName: User1, Email: user1@email.com\nName: User2, Email: user2@email.com\nName: User3, Email: user3@email.com\nName: User4, Email: user4@email.comНужно или нет тестировать контроллеры — я не редко слышу эти споры. Но факт остается фактом — есть случаи когда приложение реализует API для взаимодействия с внешним миром и такой API должен быть задокументирован и протестирован. Поэтому несколько слов о том, как тестировать WebAPI-контроллеры.
\nКак известно, контроллеры WebAPI могут возвращать результат тремя различными способами:
\nHttpResponseMessage - в этом случае результат ответа генерируется прямо в контроллере и отдается на сторону клиента “как есть”.IHttpActionResult - при этом в процессе обработки запроса он преобразуется в HttpResponseMessage и отправляется клиенту.Каждый из этих пунктов меняет подход к реализации контроллера, а значит и влияет на структуру тестов. Поэтому рассмотрим каждый случай отдельно.
\nHttpResponseMessageКонтроллер в этом случае выглядит так:
\npublic class JoinController : ApiController\n{\n public HttpResponseMessage JoinAsUser(int id)\n {\n if (id < 0)\n return Request.CreateResponse(HttpStatusCode.BadRequest);\n\n // Логика\n\n return Request.CreateResponse(HttpStatusCode.OK);\n }В результате работы действия контроллера генерируется объект HttpResponseMessage, содержимое которого мы можем проверить в тесте.
Подготовительные действия в тесте заключаются в создании и инициализации контроллера, а также задании маршрутов:
\n// Arrage\nvar controller = new JoinController\n{\n Request = new HttpRequestMessage\n {\n RequestUri = new Uri(\"http://localhost/api/join/joinAsUser\")\n },\n Configuration = new HttpConfiguration(),\n RequestContext =\n {\n RouteData = new HttpRouteData(\n route: new HttpRoute(),\n values: new HttpRouteValueDictionary\n {\n { \"controller\", \"join\" },\n { \"action\", \"joinAsUser\" }\n })\n }\n};\n\ncontroller.Configuration.Routes.MapHttpRoute(\n name: \"DefaultApi\",\n routeTemplate: \"api/{controller}/{action}/{id}\",\n defaults: new { id = RouteParameter.Optional });После чего можно обратиться к действию контроллера и проверить результат:
\n// Act\nvar result = controller.JoinAsUser(5);\n\n// Assert\nAssert.AreEqual(HttpStatusCode.OK, result.StatusCode);В данном случае производится проверка на успешный код возврата. Разумеется условия могут быть более сложными, например, включать проверки содержимого ответа.
\nИтоговый код теста:
\n[TestMethod]\npublic void JoinAsUserTest()\n{\n // Arrage\n var controller = new JoinController\n {\n Request = new HttpRequestMessage\n {\n RequestUri = new Uri(\"http://localhost/api/join/joinAsUser\")\n },\n Configuration = new HttpConfiguration(),\n RequestContext =\n {\n RouteData = new HttpRouteData(\n route: new HttpRoute(),\n values: new HttpRouteValueDictionary\n {\n { \"controller\", \"join\" },\n { \"action\", \"joinAsUser\" }\n })\n }\n };\n\n controller.Configuration.Routes.MapHttpRoute(\n name: \"DefaultApi\",\n routeTemplate: \"api/{controller}/{action}/{id}\",\n defaults: new { id = RouteParameter.Optional });\n\n\n // Act\n var result = controller.JoinAsUser(5);\n\n // Assert\n Assert.AreEqual(HttpStatusCode.OK, result.StatusCode);\n}IHttpActionResultРеализация действия контроллера в этом случае может выглядеть так:
\npublic class JoinController : ApiController\n{\n public IHttpActionResult Leave(int id)\n {\n if (id < 0)\n return BadRequest();\n\n // Логика\n\n return Ok();\n }IHttpActionResult - это обертка, которая обладает семантикой, например - запрос обработался успешно, с ошибкой, или возникли проблемы с авторизацией. В базовом классе контроллера WebAPI уже имеется набор заготовленных методов для формирования ответа в таком стиле - Ok(), Ok<>(), Redirect(), BadRequest() и т.п. Мы также можем создать свои типы ответов.
В этом случае тест будет сводиться к проверке типа ответа и его содержимого:
\n// Act\nvar result = controller.Leave(5);\n\n// Assert\nAssert.IsInstanceOfType(result, typeof(OkResult));Как и в предыдущем случае, условия проверки могут быть более сложными.
\nИтоговый код теста:
\n[TestMethod]\npublic void LeaveTest()\n{\n // Arrage\n var controller = new JoinController\n {\n Request = new HttpRequestMessage\n {\n RequestUri = new Uri(\"http://localhost/api/join/leave\")\n },\n Configuration = new HttpConfiguration(),\n RequestContext =\n {\n RouteData = new HttpRouteData(\n route: new HttpRoute(),\n values: new HttpRouteValueDictionary\n {\n { \"controller\", \"join\" },\n { \"action\", \"leave\" }\n })\n }\n };\n\n controller.Configuration.Routes.MapHttpRoute(\n name: \"DefaultApi\",\n routeTemplate: \"api/{controller}/{action}/{id}\",\n defaults: new { id = RouteParameter.Optional });\n\n\n // Act\n var result = controller.Leave(5);\n\n // Assert\n Assert.IsInstanceOfType(result, typeof(OkResult));\n}Это - частный случай прерыдущих способов. Если нам не требуется управлять HTTP-ответом, а нужно всего лишь вернуть содержимое какого-либо объекта, то можно воспользоваться таким вариантом. Выдача ошибочных статусов кодов тогда будет производится через генерацию исключений.
\nКонтроллер в этом случае выглядит так:
\npublic class JoinController : ApiController\n{\n public string CheckStatus(int id)\n {\n if (id < 0)\n throw new HttpException(400, \"Bad request\");\n\n return \"Joined\";\n }В данном примере в качестве результата отдается строка, но это может быть любой объект.
\nТестирование в данном случае наиболее прозрачное - вызывается соответствующее действие и проверяется сам объект:
\n// Act\nvar result = controller.CheckStatus(5);\n\n// Assert\nAssert.AreEqual(\"Joined\", result);Полный код теста:
\n[TestMethod]\npublic void CheckStatusTest()\n{\n // Arrage\n var controller = new JoinController\n {\n Request = new HttpRequestMessage\n {\n RequestUri = new Uri(\"http://localhost/api/join/сheckStatus\")\n },\n Configuration = new HttpConfiguration(),\n RequestContext =\n {\n RouteData = new HttpRouteData(\n route: new HttpRoute(),\n values: new HttpRouteValueDictionary\n {\n { \"controller\", \"join\" },\n { \"action\", \"сheckStatus\" }\n })\n }\n };\n\n controller.Configuration.Routes.MapHttpRoute(\n name: \"DefaultApi\",\n routeTemplate: \"api/{controller}/{action}/{id}\",\n defaults: new { id = RouteParameter.Optional });\n\n\n // Act\n var result = controller.CheckStatus(5);\n\n // Assert\n Assert.AreEqual(\"Joined\", result);\n}Роутинг в ASP.NET MVC и WebAPI позволяет сопоставить каждый HTTP-запрос с конкретным контроллером и действием. Традиционно для определения маршрутов используется таблица, описывающая схему маршрутизации. Во второй версии WebAPI появилась альтернативная возможность — задавать маршруты атрибутами, непосредственно при определении контроллера и действия.
\nАтрибуты позволяют определить сложные маршруты без лишнего усложнения основной таблицы маршрутов. Для этого каждое действие размечается атрибутом [Route].
Для использования атрибутов маршрутизации следует явно указать это при конфигурировании маршрутов. При создании ASP.NET WebAPI проекта, из шаблона создается файл App_Start/WebApiConfig.cs, содержащий записи о маршрутах для WebAPI. Здесь следует вставить вызов MapHttpAttributeRoutes() — это заставит инфраструктуру просмотреть все контроллеры/действия и учитывать их конфигурацию при роутинге тоже. Обычно код для настройки маршрутов сводится к такому:
public static void Register(HttpConfiguration config)\n{\n config.MapHttpAttributeRoutes();\n\n config.Routes.MapHttpRoute(\n name: \"DefaultApi\",\n routeTemplate: \"api/{controller}/{id}\",\n defaults: new { id = RouteParameter.Optional }\n );\n}Для задания маршрута нужно воспользоваться атрибутом [Route], в параметрах которого указать URL, который нужно связать с действием контроллера:
public class NodesController : ApiController\n{\n [Route(\"api/nodes/byowner/{ownerId}\")]\n public IEnumerable<node> GetByOwner(int ownderId)\n {\n }\n}Дополнительно может потребоваться указать HTTP-метод, при помощи которого предполагается обрабатывать запрос. Для этого есть универсальный атрибут [AcceptVerbs], либо его алиасы — [HttpGet], [HttpPost] и т.п.
Используя атрибуты легко прийти к ситуации, когда в контроллере большое количество действий, но URL для каждого из них начинается с одного и того же значения. Например:
\npublic class NodesController : ApiController\n{\n [Route(\"api/nodes/list\")]\n public IEnumerable<node> GetAll()\n {\n }\n\n [Route(\"api/nodes/byowner/{ownerId}\")]\n public IEnumerable<node> GetByOwner(int ownderId)\n {\n }\n\n [Route(\"api/nodes/byresource/{resourceId}\")]\n public IEnumerable<node> GetByResource(int resourceId)\n {\n }\n}</node>Для упрощения схемы роутинга здесь можно использовать префиксы — [RoutePrefix]. Префиксы ассоциируются с контроллером и означают, что для каждого из действий к URL будет добавлен этот префикс. Переписать код, приведенный выше можно так:
[RoutePrefix(\"api/nodes\")]\npublic class NodesController : ApiController\n{\n [Route(\"list\")]\n public IEnumerable<node> GetAll()\n {\n }\n\n [Route(\"byowner/{ownerId}\")]\n public IEnumerable<node> GetByOwner(int ownderId)\n {\n }\n\n [Route(\"byresource/{resourceId}\")]\n public IEnumerable<node> GetByResource(int resourceId)\n {\n }\n}Кстати, если какое-то из действий не укладывается в схему адресов с префиксом, это тоже решаемо — нужно указать полный URL и в начале добавить ~:
[RoutePrefix(\"api/nodes\")]\npublic class NodesController : ApiController\n{\n [Route(\"list\")]\n public IEnumerable<Node> GetAll()\n {\n }\n\n [Route(\"~/aliases/bynode/{nodeId}\")]\n public IEnumerable<Node> GetAliases(int nodeId)\n {\n }\n}Ограничения - важнейший механизм в маршрутах ASP.NET, позволяющий определить содержимое каждого параметра в URL. При маршрутизации, построенной на атрибутах есть два способа задания ограничений - в строке, при определении шаблона URL и отдельными объектами RouteConstraint.
Первый способ предполагает наличие ряда стандартных ограничений, например по типу или длине. Выглядит это так:
\n[RoutePrefix(\"api/nodes\")]\npublic class NodesController : ApiController\n{\n [Route(\"list\")]\n public IEnumerable<Node> GetAll()\n {\n }\n\n [Route(\"byowner/{ownerId:int}\")]\n public IEnumerable<Node> GetByOwner(int ownerId)\n {\n }\n [Route(\"byowner/name/{owner:maxlength(32)}\")]\n public IEnumerable<Node> GetByOwnerName(int owner)\n {\n }В список поддерживаемых ограничений входит ограничение по типам, длине, минимальному и максимальному значению, диапазонам и regex. Если этого недостаточно, то можно реализовать логику ограничения в отдельном объекте:
\npublic class ProductIdConstraint : IHttpRouteConstraint\n{\n public bool Match(HttpRequestMessage request, IHttpRoute route, string parameterName, IDictionary<string, object> values,\n HttpRouteDirection routeDirection)\n {\n bool result = false;\n\n // логика\n\n return result;\n }\n}Чтобы использовать этот класс в атрибутах, нужно его зарегистрировать:
\npublic static void Register(HttpConfiguration config)\n{\n var constraints = new DefaultInlineConstraintResolver();\n constraints.ConstraintMap.Add(\"productId\", typeof(ProductIdConstraint));\n\n config.MapHttpAttributeRoutes(constraints);Тогда его использование сводится к добавлению алиаса этого ограничения в URL:
\n[RoutePrefix(\"api/nodes\")]\npublic class NodesController : ApiController\n{\n [Route(\"byproduct/{id:productId}\")]\n public IEnumerable<Node> ByProduct(int id)\n {\n }Некоторые параметры URL могут быть опциональными. Чтобы определить опциональные параметры можно воспользоваться двумя способами.
\nПервый способ заключается в определении значения по умолчанию для параметра метода. В этом случае в шаблоне URL нужно просто указать, что параметр не является обязательным:
\n[RoutePrefix(\"api/nodes\")]\npublic class NodesController : ApiController\n{\n [Route(\"category/{id:int?}\")]\n public IEnumerable<Node> ByCategory(int id = -1)\n {\n }Другой способ — определить значение по умолчанию с самом шаблоне URL:
\n[RoutePrefix(\"api/nodes\")]\npublic class NodesController : ApiController\n{\n [Route(\"category/{id:int?=-1}\")]\n public IEnumerable<Node> ByCategory(int id)\n {\n }В большинстве ситуаций необходимости в изменении логики поиска контроллера/действия нет необходимости - с этим хорошо справляется существующая инфраструктура ASP.NET. Тем не менее, могут возникнуть ситуация, когда контроллеры расположены в другой сборке или выбор конкретного класса контроллера или его метода должны отличаться от правил, которые работают по умолчанию. ASP.NET WebAPI имеет возможность изменить это поведение в соответствии с логикой приложения.
\nОсновные точки расширения для управления этим поведением, на которые стоит обратить внимание - интерфейсы IAssembliesResolver, IHttpControllerSelector, IHttpActionSelector.
Стандартное поведение ASP.NET WebAPI при поиске контроллера - это найти класс, имя которого состоит из имени запрашиваемого контроллера и Controller. Этот класс также должен быть наследником базового класса ApiController.
Если требуется переопределить это поведение, следует реализовать сервис IHttpControllerSelector:
public class CustomControllerSelector : DefaultHttpControllerSelector\n{\n private readonly HttpConfiguration _configuration;\n\n public CustomControllerSelector(HttpConfiguration configuration)\n : base(configuration)\n {\n _configuration = configuration;\n }\n\n public override HttpControllerDescriptor SelectController(HttpRequestMessage request)\n {\n string controllerName;\n Type controllerType;\n\n // ...\n\n return new HttpControllerDescriptor(_configuration, controllerName, controllerType);\n }\n}В методе SelectController() должна быть определена логика поиска контроллера в приложении. Чтобы использовать этот объект нужно заменить соответствующий сервис в инфраструктуре ASP.NET WebAPI:
public static class WebApiConfig\n{\n public static void Register(HttpConfiguration config)\n {\n config.Services.Replace(typeof(IHttpControllerSelector), new CustomControllerSelector(config));ASP.NET WebAPI позволяет также переопределить логику поиска действия контроллера. Для этого следует создать отдельный сервис, реализующий IHttpActionSelector:
public class CustomActionSelector : ApiControllerActionSelector\n{\n public override HttpActionDescriptor SelectAction(HttpControllerContext controllerContext)\n {\n var controller = controllerContext.ControllerDescriptor;\n var controllerType = controller.ControllerType;\n\n MethodInfo action;\n\n // ...\n\n return new ReflectedHttpActionDescriptor(controller, action);\n }\n}В методе SelectAction() производится поиск метода, который будет выбран в качестве действия контроллера. Используя рефлексию, нужно сообщить инфраструктуре какой именно метод следует использовать. Замена сервиса ASP.NET WebAPI для поиска действий:
public static class WebApiConfig\n{\n public static void Register(HttpConfiguration config)\n {\n config.Services.Replace(typeof(IHttpActionSelector), new CustomActionSelector());Обработка исключений - одна из важнейших тем, о которой часто забывают и оставляют “на потом”. Типичные поведение веб-приложения при возникновении необработанного исключения - ответить клиенту с кодом HTTP 500 и формулировкой “что-то пошло не так”.
Это логично, когда мы генерируем HTML-страницы. Но реализация REST API часто требует от нас другого. Например, при появлении необработанного исключения из предметной области выдавать какой-то специфичный код возврата, чтобы наши клиенты знали в чем проблема.
\nПервое, что приходит в голову — добавить в контроллер логику, которая будет генерировать нужные коды возврата для каждой ситуации.
\nВ WebAPI есть такой механизм — Exception Filter — он позволяет для таких ситуаций создать более прозрачный код.
\nException FilterНапример, имеется WebAPI контроллер, который на определенном наборе данных генерирует NotSupportedException:
public class UsersController : ApiController\n{\n [HttpPost]\n public void Create(UsersCreateModel model)\n {\n if (....)\n throw new NotSupportedException();\n }\n}Если обратиться к такому методу через HTTP и смоделировать ситуацию, когда выбрасывается данное исключение, то в ответ будет отправлено сообщение похожее на такое:
\nHTTP/1.1 500 Internal Server Error\nCache-Control: no-cache\nPragma: no-cache\nContent-Type: application/json; charset=utf-8\nExpires: -1\nServer: Microsoft-IIS/8.0\nContent-Length: 2687\n\n{\"Message\":\"An error has occurred.\",\"ExceptionMessage\": ...Если приложение запущено в отладочной среде, здесь даже будет содержаться информация о типе исключения с подробным описанием.
\nКлиент не всегда ожидает подобного поведения. К примеру, если он отправил некорректный набор данных почему бы не вернуть ему Bad Request с описанием причины? Чтобы переопределить это поведение создадим ExceptionFilter - наследник ExceptionFilterAttribute, в котором переопределен метод OnException:
public class NotSupportedExceptionFilterAttribute : ExceptionFilterAttribute\n{\n public override void OnException(HttpActionExecutedContext context)\n {\n if (context.Exception is NotSupportedException)\n {\n context.Response = new HttpResponseMessage(HttpStatusCode.BadRequest)\n {\n Content = new StringContent(\"Data you provided is not supported.\")\n };\n }\n }\n}Как видно из этого кода, этот фильтр проверяет тип обрабатываемого исключения и при необходимости подменяет ответ. Осталось только подключить этот фильтр к приложению.
\nПодключить Exception Filter можно двумя способами:
\nЕсли логика работы данного фильтра актуальна только для конкретного контроллера или действия, то имеет смысл разметить их данным атрибутом, чтобы фильтр начал работу:
\npublic class UsersController : ApiController\n{\n [HttpPost]\n [NotSupportedExceptionFilter]\n public void Create(UsersCreateModel model)\n {\n throw new NotSupportedException();\n }\n}Возможна такая ситуация, когда логика фильтра должна работать для всего приложения. Например, мы обрабатываем все исключения, связанные с бизнес логикой и формируем корректные ответы. В этом случае можно не размечать контроллеры данным атрибутом, а добавить их при конфигурировании глобально:
\npublic static class WebApiConfig\n{\n public static void Register(HttpConfiguration config)\n {\n config.Filters.Add(new NotSupportedExceptionFilterAttribute());Теперь при выбрасывании необработанных исключений NotSupportedException, клиенту будет отправлен HTTP-ответ следующего вида:
HTTP/1.1 400 Bad Request\nCache-Control: no-cache\nPragma: no-cache\nContent-Length: 32\nContent-Type: text/plain; charset=utf-8\nExpires: -1\nServer: Microsoft-IIS/8.0\n\nData you provided is not supported.ASP.NET предлагает хорошую инфраструктуру для серверного кода, но веб-приложения - это ещё и фронтенд. Клиентский код нужно процессить, упаковывать, минифицировать, разбивать на пакеты и т.п. В мире .NET популярен так же Nuget, который содержит множество полезных пакетов. Но в JavaScript мире эту роль выполняет Bower. Поэтому давайте попробуем подключить Grunt (для автоматизации работы с клиентским кодом) и Bower (в качестве пакетного менеджера для JavaScript).
\nК сожалению, ASP.NET MVC не имеет встроенной поддержки Grunt и Bower. Поэтому для их корректной работы предварительно необходимо установить несколько nuget-пакетов:
\nInstall-Package Npm\nInstall-Package Grunt\nInstall-Package BowerЭти пакеты подтянут остальные зависимости, необходимые для работы. В результате установки пакетов, в папке проекта появится папка .bin - не удаляйте её. Эта папка содержит файлы для запуска Grunt и Bower.
Этого уже достаточно, чтобы запускать grunt и bower в ручном режиме - для этого необходимо запускать соответствующие файлы из папки .bin.
![\"Подключаем](\"https://blog.zwezdin.com/2014/aspnet-mvc-grunt-bower/d8c1829c/1@2x.png\")
\n\n\n\n\nЕсли требуется делать то же самое при сборке проекта, то необходимо немного модифицировать файл проекта - в самый конец файла .csproj дописываем директивы для запуска npm, grunt и bower:
<Target Name=\"NpmBuild\" BeforeTargets=\"Build\">\n <Exec Command=\".bin\\npm install\" />\n </Target>\n <Target Name=\"BowerInstall\" AfterTargets=\"NpmBuild\">\n <Exec Command=\".bin\\bower install\" />\n </Target>\n <Target Name=\"GruntBuild\" AfterTargets=\"BowerInstall\">\n <Exec Command=\".bin\\grunt\" />\n </Target>\n</Project>Теперь при сборке ASP.NET MVC проекта будут также запускаться инструменты для сборки клиентского кода.
\nДля работы Grunt и Bower требуется создать несколько файлов - package.json и bower.json, а так же сам скрипт для сборки - gruntfile.js.
Необходимо открыть консоль Windows и перейти в папку проекта. После этого последовательно запускаем:
\nnpm initПосле этого нужно будет ответить на несколько вопросов в интерактивном режиме (имя проекта, версия и т.п.). На этом шаге будет создан файл package.json.
bower initВсе то же самое, но результате создается файл bower.json. При установке пакетов из Bower они будут попадать в папку bower_components. Если вас это не устраивает, то можно добавить в проект файл с именем .bowerrc и переопределить это поведение:
{\n \"directory\": \"Scripts/.bower_components\"\n}И последнее - нужно добавить в папку проекта файл gruntfile.js - это скрипт, который будет выполняться при запуске grunt. Пустой скрипт может выглядеть так:
module.exports = function (grunt) {\n\n grunt.initConfig({\n pkg: grunt.file.readJSON(\"package.json\")\n });\n\n grunt.registerTask(\"default\", []);\n\n};Более подробно о содержимом этого файла можно почитать на официальном сайте Grunt.
\nТеперь, когда grunt и bower установлены и подключены к проекту, самое время попробовать установить пакеты из общего репозитория.
\nУстановка пакетов - это прописывание соответствующих директив в package.json/bower.json с последующим запуском этих инструментов. Поэтому существует два способа подключения пакетов - вручную добавить их в указанные файлы, либо воспользоваться инструментами и подключить их из командной строки. Попробуем сделать это.
Подключим, для начала, пакет grunt-contrib-clean. Это пакет, который занимается очисткой папок перед сборкой. В командной строке выполняем
npm install grunt-contrib-clean --save-devЕсли заглянуть теперь в package.json, то будет видно, что туда добавился новый элемент:
\"devDependencies\":\n{\n \"grunt\": \"^0.4.5\",\n \"grunt-contrib-clean\": \"^0.6.0\"\n}Кроме того, в папке проекта появилась папка node_modules, которая содержит код этого пакета. На практике эти папки не распространяются с исходным кодом. Т.е. мы можем спокойно удалить папку node_modules и передать код коллеге. Все что нужно сделать в этом случае, на новом месте запустить:
npm installПри запуске этой команды Npm создаст папку node_modules и установит туда все зависимости, которые сейчас находятся в файл package.json. Поскольку мы добавили соответствующие директивы в файл проекта .csproj, запуск этой команды вручную не потребуется - все зависимости будут загружены автоматически при сборке проекта.
Похожа ситуация и с Bower. Подключение пакета:
\nbower install -S jqueryВ bower.json добавляется при этом нужна зависимость:
\"dependencies\":\n{\n \"jquery\": \"~2.1.1\",\n}Распространять вместе с проектом папку bower_components тоже не обязательно. Для того, чтобы скачать все подключенные пакеты достаточно запустить следующую команду:
bower installТак же как и для Npm, пакеты Bower будут подтягиваться автоматически при сборке проекта, поэтому запускать эту команду вручную необязательно.
\nКак видно, логика подключения пакетов из Npm и Bower очень похожа на Nuget. Напоследок, предлагаю посмотреть как при помощи этих инструментов решаются практические задачи.
\nПредположим у нас есть JavaScript-код, который требуется упаковать в один файл и минифицировать. Для каждой задачи по автоматизации нужно найти подходящий пакет в официальном репозитории. В нашем случае подойдет пакет grunt-contrib-uglify.
\nПодключаем пакет к проекту:
\nnpm install grunt-contrib-uglify --save-devДобавляем в скрипт gruntfile.js:
module.exports = function (grunt) {\n grunt.initConfig({\n pkg: grunt.file.readJSON(\"package.json\"),\n\n uglify: {\n \"WebApp27\": {\n files: {\n \"dist/result.js\": [\n \"Scripts/controller1.js\",\n \"Scripts/controller2.js\"]\n }\n }\n }\n });Смысл скрипта заключается в том, что мы берем файлы controller1.js и controller2.js, минифицируем их, а результат складываем в result.js.
Когда это готово, вызовом метода loadNpmTasks загружаем пакет Uglify при сборке и запускаем его вместе с остальными задачами:
module.exports = function (grunt) {\n grunt.initConfig({\n pkg: grunt.file.readJSON(\"package.json\"),\n\n uglify: {\n \"WebApp27\": {\n files: {\n \"dist/result.js\": [\n \"Scripts/controller1.js\",\n \"Scripts/controller2.js\"]\n }\n }\n }\n });\n\n grunt.loadNpmTasks(\"grunt-contrib-uglify\");\n\n grunt.registerTask(\"default\", [\"uglify\"]);\n};Теперь при запуске grunt из командной строки или при сборке ASP.NET проекта, задача по минификации будет также запущена и файл result.js будет содержать минифицированный вариант.
Подробнее о синтаксисе этого скрипта можно почитать на официальном сайте Grunt.
\nДругой задачей, часто решаемой при помощи Grunt является сборка LESS-файлов. Аналогично предыдущему примеру установим пакет grunt-contrib-less и добавим его директиву в gruntfile.js:
module.exports = function(grunt) {\n grunt.initConfig({\n pkg: grunt.file.readJSON(\"package.json\"),\n\n // ...\n\n less: {\n styles: {\n files: [\n {\n \"dist/styles.css\": \"styles/styles.less\"\n }\n ]\n }\n\n }\n });\n\n // ...\n grunt.loadNpmTasks(\"grunt-contrib-less\");\n\n grunt.registerTask(\"default\", [/*...*/, \"less\"]);\n};Добавим файл styles/styles.less в проект:
@color1: #fff;\n\nbody {\n background-color: @color1;\n}И запустим сборку. В итоге в файле dist/styles.css будет содержаться результат компиляции LESS-файла:
body {\n background-color: #ffffff;\n}30 мая прошла одна из крупнейших в регионе конференций - UWDC 2014. О том, как это было я и хочу рассказать.
\nПланировать UWDC мы начали за несколько месяцев. Изначально не всё шло гладко, но в целом конференция получилась. Большая заслуга в этом – Андрея Ситко, который руководил всем процессом и ежедневно решал большое количество вопросов.
\nИ вот наступил этот день – 30 мая. Программу мы запланировали обширную – в отличие от прошлых лет, конференция проходила в 1 день, но доклады шли плотно, в несколько потоков. Поэтому всем организатором в процессе проведения конференции скучать не приходилось.
\nНачалось как и всегда с регистрации.
\n\n\n\n![\"UWDC](\"https://blog.zwezdin.com/2014/uwdc-2014/ffcc1ef1/1@2x.jpg\")
\n\n\n\n\nНе без проблем, но удалось в этом году организовать и онлайн-трансляцию.
\n\n\n\n![\"UWDC](\"https://blog.zwezdin.com/2014/uwdc-2014/a9910186/2@2x.jpg\")
\n\n\n\n\n\n\n\n ![\"UWDC](\"https://blog.zwezdin.com/2014/uwdc-2014/34f1c71a/3@2x.jpg\")
\n\n\n\n\nНа мой взгляд докладчики очень порадовали уровнем докладов и качеством исполнения. Практически каждый доклад сопровождался серией вопросов и обсуждения продолжались в кулуарах.
\n![\"Как](\"https://blog.zwezdin.com/2014/uwdc-2014/dda01c12/4@2x.jpg\")
![\"Real](\"https://blog.zwezdin.com/2014/uwdc-2014/f33da56a/5@2x.jpg\")
![\"Как](\"https://blog.zwezdin.com/2014/uwdc-2014/482d0aa2/6@2x.jpg\")
![\"Живые](\"https://blog.zwezdin.com/2014/uwdc-2014/e7bc8a60/7@2x.jpg\")
![\"Xamarin.](\"https://blog.zwezdin.com/2014/uwdc-2014/c45bf681/8@2x.jpg\")
![\"Использование](\"https://blog.zwezdin.com/2014/uwdc-2014/5c6c8647/9@2x.jpg\")
![\"Фото](\"https://blog.zwezdin.com/2014/uwdc-2014/69f8b0e2/10@2x.jpg\")
Для меня этот день начался в 6 утра, а вернулся домой я уже за полночь, но это того стоило! :-)
\nНадеюсь, у меня получилось передать атмосферу мероприятия. Приходите на UWDC 2015! :-)
", "tags": [ "Мероприятия", "UWDC" ], "banner_image": "https://blog.zwezdin.com/2014/uwdc-2014/1c5fa5e0/uwdc_2014@cover.jpg" }, { "id": "https://blog.zwezdin.com/2014/mvc-build-views/", "url": "https://blog.zwezdin.com/2014/mvc-build-views/", "title": "Компиляция представлений в ASP.NET MVC", "date_published": "2014-05-31T12:00:00.000Z", "content_html": "Любой код, написанный для платформы .NET должен быть скомпилирован, и это прекрасно. Компиляция позволяет быть уверенным в том, что код корректный и в нем нет синтаксических ошибок. К сожалению, компиляция обязательная не всегда - представления ASP.NET MVC можно изменять без компиляции представлений. Нет, компиляция, конечно, есть, но она выполняется непосредственно перед запуском этого кода. И если в коде содержится синтаксическая ошибка, то узнаем мы о ней только тогда, когда запустим приложение. Из представления мы можем обращаться к моделям, которые так же могу измениться и приложение перестанет работать.
\nЧтобы изменить это поведение, в проекте ASP.NET MVC существует специальный параметр — MvcBuildViews. Если установить этот параметр в true, то в процессе сборки приложения, представления тоже будут компилироваться. Это означает, что если у вас есть ошибки в представлениях, вы увидите их уже на этапе компиляции.
Небольшое замешательство вызывает тот факт, что в свойствах проекта ASP.NET нет опции, чтобы изменить этот параметр. Поэтому, чтобы воспользоваться этой возможностью, придется немного поработать руками. И для этого есть два способа.
\nПервый способ заключается в том, чтобы запустить сборку проекта с явно заданным значением параметра MvcBuildViews:
MSBuild.exe WebProject.csproj /p:MvcBuildViews=trueВнутри msbuild-скрипта это может выглядеть вот так:
\n<MSBuild Projects=\"WebProject.csproj\" Targets=\"Build\" Properties=\"MvcBuildViews=true\"/>Второй способ - задать значение параметра MvcBuildViews прямо в файле проекта. К сожалению, Visual Studio не предоставляет для этого инструментов, поэтому в текстовом редакторе нужно открыть файл проекта .csproj и изменить значение этого параметра:
![\"Компиляция](\"https://blog.zwezdin.com/2014/mvc-build-views/f21e0a04/1@2x.png\")
\n\n\n\n\nЕсли параметр отсутствует, то нужно просто создать узел с именем MvcBuildViews и задать значение внутри него.
После этих манипуляций при сборке проекта ASP.NET MVC представления будут компилироваться вместе с основным проектом и если они содержат ошибки, они будут выявлены ещё на этапе компиляции.
", "tags": [ "ASP.NET" ], "banner_image": "https://blog.zwezdin.com/2014/mvc-build-views/3c1c93b4/mvc_build-views@cover.png" }, { "id": "https://blog.zwezdin.com/2014/razor-for-email-templates/", "url": "https://blog.zwezdin.com/2014/razor-for-email-templates/", "title": "Использование Razor для генерации содержимого сообщения email", "date_published": "2014-05-29T12:00:00.000Z", "content_html": "Многие веб-приложения в процессе работы отправляют email-сообщения. И содержимое сообщений могут содержать как простой текст, так и HTML-разметку. Последний вариант предпочтительнее, если хочется видеть красиво отформатированное сообщение. Встает вопрос - а как генерировать эту разметку?
\nСуществует множество библиотек, которые так или иначе решают эту задачу. Однако, если мы присмотримся, то увидим, что Razor - движок представлений в ASP.NET MVC - решает именно эту задачу, но для выдачи в браузер. Так почему же не приспособить Razor для генерации содержимого сообщений электронной почты?
\nViewEngines.Engines.FindPartialView.ViewContext, который содержит информацию о текущем контексте (ViewData, модель, параметры) - его просто нужно создать и определить начальные значения.StringWriter - это стандартный прием, используемый движками представлений ASP.NET MVC.ReleaseView.Можно сделать метод-расширение, который выполняет эти действия:
\npublic static class ViewEngineExtensions\n{\n public static string RenderPartialView(this ControllerContext context,\n string viewName, object model = null)\n {\n StringBuilder result = new StringBuilder();\n\n using (var writer = new StringWriter(result))\n {\n var viewData = new ViewDataDictionary {Model = model};\n\n var view = ViewEngines.Engines.FindPartialView(context, viewName);\n var viewContext = new ViewContext(context, view.View, viewData,\n new TempDataDictionary(), writer);\n\n view.View.Render(viewContext, writer);\n view.ViewEngine.ReleaseView(context, view.View);\n }\n\n return result.ToString();\n }\n}Для генерации результата необходимо создать представление. Пусть это будет представление с именем _Message.cshtml, размещенное в папке Views/Shared:
@model int\n<p>Value is <b>@Model</b></p>Тогда код генерации результата и отправки email-сообщения будет выглядеть следующим образом:
\nusing (SmtpClient smtp = new SmtpClient())\n{\n MailMessage message = new MailMessage\n {\n Subject = \"Test Message\",\n IsBodyHtml = true,\n Body = ControllerContext.RenderPartialView(\"_Message\", 22)\n };\n\n message.To.Add(@\"noreply@email.com\");\n\n smtp.Send(message);\n}В Visual Studio 2013 появился новый инструмент, помогающий при разработке веб-приложений — Browser Link. Идея Browser Link заключается в том, что Visual Studio и браузер имеют постоянный канал связи. Это позволяет централизованно управлять браузерами из Visual Studio. Чтобы лучше понять как работает Browser Link, давайте подключим этот инструмент к веб-сайту.
\nЧтобы использовать Browser Link должны быть соблюдены следующие условия:
\nlocalhost.debug=true в секции <compilation> в конфигурационном файле).Для включения Browser Link в Visual Studio 2013 появилась специальная кнопка на панели управления:
\n\n\n\n![\"Browser](\"https://blog.zwezdin.com/2014/visual-studio-browserlink/56316699/1@2x.png\")
\n\n\n\n\nВ этом же меню присутствует ссылка на Browser Link Dashboard — панель, на которой отображаются все активные подключения.
\nТеперь, когда мы включили Browser Link в Visual Studio, можно запустить веб-сайт. Если мы заглянем в исходный код страницы, то там можно увидеть, что в нее встроен код, который обеспечивает поддержку работы Browser Link на стороне браузера.
\n\n\n\n![\"Browser](\"https://blog.zwezdin.com/2014/visual-studio-browserlink/b30ceb09/2@2x.png\")
\n\n\n\n\nЭтот код добавляется автоматически и только в том случае, если проект запущен локально. При развертывании на удаленном сервере этого кода не будет. Более того, если для конкретного проекта требуется запретить использование Browser Link, то это можно сделать в файле конфигурации, добавив параметр vs:EnableBrowserLink:
<appSettings>\n <add key=\"vs:EnableBrowserLink\" value=\"false\"/>\n</appSettings>После открытия страницы в различных браузеров можно вернуться в Visual Studio и открыть Browser Link Dashboard - здесь будут видны все активные подключения.
\nЕсли мы теперь откроем нужную страницу в браузерах, а затем изменим её в Visual Studio, то нам не нужно открывать каждый браузер и нажимать F5. Теперь достаточно выбрать пункт меню Refresh Linked Browsers (или просто Ctrl + Alt + Enter) и страница будет обновлена во всех браузерах.
Если взглянуть на то, как это устроено, то работает это очень просто — при запуске веб-сайта при помощи SignalR устанавливается соединения клиентской части веб-сайта и Visual Studio. По этому каналу и происходит взаимодействие. Минусом такого подхода, кстати, будет то, что если у вас в приложении так же имеется SignalR-подключение, то они будут конфликтовать.
\nНа первый взгляд может показаться, что это очень незначительная возможность Visual Studio, которая к тому же требует определенной предварительно настройки. На самом же деле Browser Link — это своего рода базовый API, поверх которого можно реализовать собственные сценарии управления клиентским кодом из Visual Studio. Например, некоторые такие сценарии реализованы в популярном плагине Web Essentials.
", "tags": [ "ASP.NET", "Visual Studio" ], "banner_image": "https://blog.zwezdin.com/2014/visual-studio-browserlink/6fef1f95/visual_studio-browserlink@cover.png" }, { "id": "https://blog.zwezdin.com/2014/visual-studio-installer-project/", "url": "https://blog.zwezdin.com/2014/visual-studio-installer-project/", "title": "Возможность создания пакетов установщиков вернулась в Visual Studio", "date_published": "2014-04-19T12:00:00.000Z", "content_html": "Несколько лет назад Microsoft прекратила поддержку создания пакетов установки в Visual Studio. Тогда было предложено воспользоваться технолгией ClickOnce (где это возможно), либо работать с InstallShield напрямую. Однако, отзывы разработчиков делают своё дело и сегодня анонсировано расширение Visual Studio, которое возвращает поддержку этой функциональности в Visual Studio.
\nВнешне пакеты установщиков не особо изменились, так же как и не изменился процесс их создания.
\n\n\n\n![\"Возможность](\"https://blog.zwezdin.com/2014/visual-studio-installer-project/02614aca/visual-studio-installer-project@2x.png\")
\n\n\n\n\nДумаю эта новость может обрадовать многих, кто использовал эту функциональность и потом лишился её.
", "tags": [ "Visual Studio" ], "banner_image": "https://blog.zwezdin.com/2014/visual-studio-installer-project/3b16cc7a/visual_studio-installer-project@cover.png" }, { "id": "https://blog.zwezdin.com/2014/sql-server-data-tools/", "url": "https://blog.zwezdin.com/2014/sql-server-data-tools/", "title": "Версионирование схемы базы данных при помощи SQL Server Data Tools (SSDT)", "date_published": "2014-03-29T12:00:00.000Z", "content_html": "Большинство команд в своих проектах давно научились использовать системы контроля версий для хранения истории изменения кода. Но многие до сих пор не могут четко ответить на вопрос, что в этом случае делать с базой данных. Здесь я расскажу а том, как использовать SSDT для решения этого вопроса.
\nЗа время своей работы мне приходилось сталкиваться с различными подходами к версионированию схемы базы данных. Начиная от того, что схема никак не версионировалась, заканчивая фреймворками по миграции данных (DotNetMigrations, EF Migrations). В итоге мы остановились на использовании SQL Server Data Tools.
\nДавайте разберемся как работают фреймворки миграции. В них всё предельно просто - каждый раз когда меняется схема данных, мы создаем новую миграцию (инкремент схемы данных), в которой указываем что конкретно должно измениться в схеме данных. Например, это может быть создание новой таблицы или изменение существующей. DotNetMigration работают на уровне SQL-скриптов, каждый новый инкремент - новый скрипт. EF Migrations позволяют работать с этим в виде объектов, но идея также. В качестве бонуса при создании миграции можно управлять данными (например, заполнить новую таблицу тестовыми/начальными данными). Для того, чтобы воссоздать схему базы данных, вам нужно последовательно запустить все миграции одну за другой. При этом в системе контроля версий у вас хранится несколько файлов (для каждой миграции) и они неизменны.
\nВ альтернативу этому подходу, SSDT предлагает хранить в системе контроля версий текущую схему базы данных, а все инкременты доступны в виде истории комитов. По сути, SSDT позволяет создавать database-проекты и публиковать их на нужном сервере. Давайте более подробно рассмотрим процесс использования SSDT.
\nДля работы с SSDT на компьютер следует установить соответствующий пакет, который можно загрузить с официального сайта. После установки этого пакета, в шаблонах проекта появится новый тип проектов - “SQL Server Database Project”.
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/8696d344/install@2x.png\")
\n\n\n\n\nПроект готов и мы можем приступить к созданию схемы БД. Для этого добавим в проект новые таблицы.
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/5bea9df5/create-schema@2x.png\")
\n\n\n\n\nДля таблиц существует встроенный редактор, который на лету генерирует SQL-скрипт для создания таблицы (который, впрочем, можно редактировать и руками).
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/87cf2449/table-editor@2x.png\")
\n\n\n\n\nЗдесь же можно построить индексы, добавить триггеры, а также связать таблицу с другими таблицами.
\nВ SSDT вы можете работать практически со всеми необходимыми артефактами базы данных Microsoft SQL Server - таблицы, индексы, хранимые процедуры и функции, пользователи и т.д.
\nПосле того, как проект готов, мы можем опубликовать его на реальном сервере. Для этого кликаем правой кнопкой по проекту и выбираем опцию “Publish”.
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/04a0a954/publish@2x.png\")
\n\n\n\n\nПри публикации SSDT сравнивает схему целевой базы данных и схему нашего проекта и строит инкремент - скрипт, который адаптирует схему данных целевой базы данных в соответствии со схемой нашего проекта (грубо говоря, набор ALTER TABLE и пр.). Логично, что данные при этом на целевом сервере никуда не исчезают, если это не противоречит самой схеме.
Если есть риск потерять данные (например, удалилась колонка, или вы добавляете колонку с не-NULL значением, но строки в этой таблице уже есть), то при публикации SSDT поругается и схема БД развернута не будет. В этом случае нужно что-то предпринимать. В идеале, таких ситуаций лучше избегать. Например, если вы добавляете новую не-NULL колонку к существующей таблице, то указать для неё значение по умолчанию. В некоторых случаях достаточно разрешить SSDT удалить какие-то данные ради успеха общего дела (Advanced → Block incremental deployment if data loss may occur).
![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/f0ccb63d/advanced-settings@2x.png\")
\n\n\n\n\nПосле успешной публикации, обновленная схема БД появится на целевом сервере.
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/c684b327/tables@2x.png\")
\n\n\n\n\nВ процессе публикации SSDT также создает инкремент-скрпит (.sql). Некоторые коллеги также сохраняют и его как артефакт процесса сборки.
В нашем случае проект SSDT входит в общий состав Solution’а и собирается вместе с остальными проектами на билд-сервере. Также как и запускается публикация на SQL-сервер в процессе развертывания. Важно, что если у вас есть какие-то ошибки или неточности, например, в описании ваших таблиц, то SSDT-проект не соберется и сборка остановится. Это очень помогает.
\nСхема базы данных - это часть проекта, которая развивается вместе с ним. Появляются новые таблицы, связи, индексы, ключи. И если с добавлением новых сущностей в проект все понятно (они просто появятся в схеме при развертывании), то что делать с изменениями уже существующих сущностей?
\nДопустим у нас есть таблица и мы хотим добавить в нее новое поле. В этом случае мы просто делаем это и при развертывании мы получим обновленную таблицу.
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/4f1ebfef/refactoring-editor@2x.png\")
\n\n\n\n\n\n\n\n ![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/ad6eaac2/refactoring-tables@2x.png\")
\n\n\n\n\nСложнее дела обстоят с другими изменениями. Например, если вам нужно переименовать колонку, то вам наверняка захочется, чтобы данные в целевой базе данных сохранились. Для этого нужны рефакторинги в SSDT. Давайте посмотрим на примере. Заполню данными таблицу из предыдущего примера.
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/0944c936/refactoring-tables2@2x.png\")
\n\n\n\n\nПосле чего в проекте SSDT я изменю название одной из колонок.
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/e6cc965f/refactoring-editor2@2x.png\")
\n\n\n\n\nПубликую обновленный проект на сервер.
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/a17c26cd/refactoring-tables3@2x.png\")
\n\n\n\n\nСхема изменилась, данные сохранились.
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/2dec144b/refactoring-tables4@2x.png\")
\n\n\n\n\nПроисходит это за счет того, что при каждом таком изменении, SSDT хранит лог рефакторинга. Это - файл .refactorlog, который хранится в проекте в формате XML.
![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/a6a3db92/refactoring-script@2x.png\")
\n\n\n\n\nВ самой базе данных эта информация тоже сохраняется.
\n\n\n\n![\"Версионирование](\"https://blog.zwezdin.com/2014/sql-server-data-tools/47a682a4/refactoring-log@2x.png\")
\n\n\n\n\nТаким образом, SSDT может гарантировать, что ваши данные не потеряются.
\nСам по себе инструмент рефакторинга - это мощный инструмент. Однако, набор рефакторингов пока крайне ограничен. Например, вы не можете удалить колонку из одной таблицы, поместить её в дургую и при этом сохранить данные. Полный список рефакторингов вы можете увидеть по этой ссылке.
\nВ итоге мы получаем инструмент со своими плюсами и минусы, которые в заключение я хочу перечислить.
\nПлюсы:
\nМинусы:
\nЯ уже рассматривал вопрос о том, как создать собственный Nuget-сервер и как создать Nuget-пакет с помощью графической утилиты. На этот раз я расскажу как сделать то же самое, используя только консольную утилиту nuget.exe.
Необходимость использовать консольную утилиту может появиться тогда, когда нам нужно встроить сборку пакетов в процесс автоматической сборки проекта. В этих случаях использование графической утилиты становится малореальным.
\nДля работы нам потребуется консольная утилита nuget.exe, которую можно загрузить с официального сайта. Описание работы с этой утилитой можно найти здесь.
Создать пакет в этом случае можно разными способами.
\nЕсли вам требуется создать простой пакет, где будет содержаться одна сборка можно воспользоваться следующей командой:
\nnuget spec Core.dllЭта команда создаст файл манифеста (nuspec), необходимого для создания пакета.
В более сложных случаях, когда в пакете содержится множество файлов и скриптов по установке, можно создать этот файл самостоятельно (спецификация nuspec), так же как и структуру папок.
Другим вариантом будет использование графической утилиты, в которой существует опция Export:
![\"Создание](\"https://blog.zwezdin.com/2014/building-nuget-packages-with-nuget-exe/22621057/1@2x.png\")
\n\n\n\n\nВ этом случае вы получите всю структуру папок и файлов, а также файл nuspec без лишних усилий. После этого вы можете изменять манифест nuspec (поскольку это — обычный файл XML), например, в процессе автоматизированной сборки.
После того, как все необходимые файлы готовы, а также создан манифест пакета, достаточно запустить утилиту nuget.exe со следующими параметрами:
nuget pack MyPackage.1.0.0.nuspecВ результате работы этой утилиты мы получим файл nupkg, который готов к публикации на сервере. По сути, файл nupkg — это ZIP-архив, внутри которого находится всё содержимое пакета в установленном формате.
Для публикации пакета необходимо использовать следующую команду nuget.exe:
nuget push MyPackage.1.0.0.nupkg 1ab183523cx7usf -s http://nuget.somecompany.com/Как видно из формата команды, мы указываем имя пакета, ключ сервера и адрес сервера.
\nЕсли мы всё время работаем с одним и тем же nuget-сервером, то эти параметры можно определить в конфигурационном файле, который расположен по указанному пути — %AppData%\\NuGet\\NuGet.config.
В этом случае команда по публикации будет немного короче:
\nnuget push MyPackage.1.0.0.nupkgЕсли вы публикуете свои пакеты на nuget.org, то вам необходимо зарегистрироваться там и получить ключ. После этого выполнить команду:
NuGet SetApiKey Your-API-KeyВ этом случае вы также можете использовать сокращенный синтаксис команды. Как можно догадаться, в этом случае будут просто изменены параметры в конфигурационном файле.
", "tags": [ "Nuget" ], "banner_image": "https://blog.zwezdin.com/2014/building-nuget-packages-with-nuget-exe/07ca8a59/building_nuget-packages-with-nuget-exe@cover.jpg" }, { "id": "https://blog.zwezdin.com/2014/building-nuget-packages-with-gui-tool/", "url": "https://blog.zwezdin.com/2014/building-nuget-packages-with-gui-tool/", "title": "Создание nuget-пакетов при помощи GUI-утилиты", "date_published": "2014-03-02T12:00:00.000Z", "content_html": "Недавно я писал о том, как создать собственный Nuget-сервер для локальных нужд. Для того, чтобы картина была полной, опишу процесс создания пакета nuget. Существует два разных способа сделать это — создать все артефакты руками и использовать утилиту nuget.exe для упаковки, либо воспользоваться графической утилитой. Рассмотрим второй вариант.
При создании nuget-пакетов преимущества графической утилиты перед консольной очевидны — не нужно создавать все артефакты руками, все просто и интуитивно. Поэтому рассмотрим этот способ подробнее.
\nПервое, что нужно сделать — это установить утилиту для создания пакетов. Загрузить её можно здесь.
\n\n\n\n![\"Создание](\"https://blog.zwezdin.com/2014/building-nuget-packages-with-gui-tool/8d2b31a8/1@2x.png\")
\n\n\n\n\nЭто — ClickOnce-установщик и вам нужно дождаться загрузки и установки приложения на компьютер.
\nСразу после запуска утилиты, будет предложено несколько опций - создать новый пакет или открыть существующий (локально или из ленты Nuget-сервера). Давайте рассмотрим процесс создания пакета. Выбираем пункт Create a new package.
![\"Создание](\"https://blog.zwezdin.com/2014/building-nuget-packages-with-gui-tool/4b604e19/2@2x.png\")
\n\n\n\n\nЗаполним информацию о нашем Nuget-пакете. Для этого в меню выбираем Edit → Edit Metadata:
![\"Создание](\"https://blog.zwezdin.com/2014/building-nuget-packages-with-gui-tool/16aac3f0/3@2x.png\")
\n\n\n\n\nЗдесь же можно установить зависимости нашего пакета на другие пакеты и сборки:
\n\n\n\n![\"Создание](\"https://blog.zwezdin.com/2014/building-nuget-packages-with-gui-tool/2ac165e7/4@2x.png\")
\n\n\n\n\nПосле того, как информация о пакете заполнена, можно приступить к наполнению пакета.
\nВ правой части окна видна секция Content, которая отображает содержимое текущего пакета.
При помощи пункта меню CONTENT добавим все необходимые файлы в пакет:
![\"Создание](\"https://blog.zwezdin.com/2014/building-nuget-packages-with-gui-tool/851b06b8/5@2x.png\")
\n\n\n\n\nНаш nuget-пакет готов.
\n\n\n\n![\"Создание](\"https://blog.zwezdin.com/2014/building-nuget-packages-with-gui-tool/073225a0/6@2x.png\")
\n\n\n\n\nСохраним полученный пакет в файловой системе, получим nupkg-файл, готовый для публикации.
Полученный пакет можно опубликовать на сервере стандартными средствами nuget.exe, либо при помощи той же утилиты. Для этого используем пункт меню File → Publish:
![\"Создание](\"https://blog.zwezdin.com/2014/building-nuget-packages-with-gui-tool/112f6a30/7@2x.png\")
\n\n\n\n\nВ открывшемся диалоговом окне укажем адрес нашего сервера и ключ для публикации. После этого шага проект будет опубликован и его можно использовать в ваших проектах.
", "tags": [ "Nuget" ], "banner_image": "https://blog.zwezdin.com/2014/building-nuget-packages-with-gui-tool/82f648ae/building_nuget-packages-with-gui-tool@cover.png" }, { "id": "https://blog.zwezdin.com/2014/aspnet-mvc-throttling/", "url": "https://blog.zwezdin.com/2014/aspnet-mvc-throttling/", "title": "Регулирование нагрузки на веб-приложение ASP.NET MVC", "date_published": "2014-03-01T12:00:00.000Z", "content_html": "Бывают ситуации, когда внешние ресурсы обращаются к веб-приложению слишком часто. Это могут быть краулеры или другие роботы. Если это создает проблемы для производительности приложения, то такие запросы можно ограничить. В данной статье я расскажу как это сделать для приложения ASP.NET MVC.
\nДля того, чтобы ограничить количество запросов, обрабатываемых в единицу времени можно воспользоваться библиотекой MvcThrottle.
\nСоздадим проект и установим пакет из Nuget:
\nInstall-Package MvcThrottleКак только пакет установлен, можно использовать фильтр ThrottlingFilter для регулирования нагрузки. Зарегистрируем этот фильтр глобально:
public static void RegisterGlobalFilters(GlobalFilterCollection filters)\n{\n filters.Add(new ThrottlingFilter\n {\n Policy = new ThrottlePolicy(1, null, null, null, null) { IpThrottling = true }\n });\n}Для того, чтобы включить регулирование нагрузки для контроллера или действия его нужно разметить атрибутом [EnableThrottling].
public class HomeController : Controller\n{\n [EnableThrottling]\n public ActionResult Index()\n {\n return View();\n }\n}Этого достаточно, чтобы включить регулирование нагрузки для действия контроллера ASP.NET MVC.
\nВ приведенной выше конфигурации нагрузка ограничивается одним запросом в секунду. Этот параметр можно настраивать более тонко:
\npublic static void RegisterGlobalFilters(GlobalFilterCollection filters)\n{\n filters.Add(new ThrottlingFilter\n {\n Policy = new ThrottlePolicy(\n perSecond: 5,\n perHour: 200,\n perDay: 4000) { IpThrottling = true }\n });\n}Кроме того, эту настройку можно выполнить индивидуально для каждого действия или контроллера:
\npublic class HomeController : Controller\n{\n [EnableThrottling(PerSecond = 10)]\n public ActionResult Index()\n {\n return View();\n }\n}При превышении доступного значения, приложение отдает ошибку HTTP 429.
![\"Регулирование](\"https://blog.zwezdin.com/2014/aspnet-mvc-throttling/cdfadfb4/1@2x.png\")
\n\n\n\n\nПри желании можно настроить это поведение:
\npublic static void RegisterGlobalFilters(GlobalFilterCollection filters)\n{\n filters.Add(new ThrottlingFilter\n {\n Policy = new ThrottlePolicy(\n perSecond: 5,\n perHour: 200,\n perDay: 4000)\n {\n IpThrottling = true\n },\n QuotaExceededResponseCode = HttpStatusCode.Forbidden,\n QuotaExceededMessage = \"Try again later\"\n });\n}Кроме того, можно настроить:
\nTFS2013 имеет очень удобный функционал Code Review - каждый член команды может сделать запрос на ревью для одного или нескольких членов команды. Мы задались вопросом можно ли такие Code Review создавать автоматически при комите в систему контроля версий.
\nДля того, чтобы реализовать эту функциональность мы воспользовались серверными событиями (TFS Server Side Events). Их суть предельно проста - мы создаем объект-подписчик, метод которого будет вызываться, когда в TFS что-то происходит, и если тип события тот, который нас устраивает, то обрабатываем эту ситуацию.
Для того, чтобы создать такой объект-подписчик достаточно создать новую сборку, в которой создать объект, реализующий интерфейс ISubscriber из пространства имен Microsoft.TeamFoundation.Framework.Server.
Предварительно следует добавить ссылки на следующие сборки:
\nC:\\Program Files (x86)\\Microsoft Visual Studio 12.0\\Common7\\IDE\\ReferenceAssemblies\\v2.0\\Microsoft.TeamFoundation.Client.dllC:\\Program Files (x86)\\Microsoft Visual Studio 12.0\\Common7\\IDE\\ReferenceAssemblies\\v2.0\\Microsoft.TeamFoundation.Common.dllC:\\Program Files\\Microsoft Team Foundation Server 12.0\\Tools\\Microsoft.TeamFoundation.Framework.Server.dllC:\\Program Files\\Microsoft Team Foundation Server 12.0\\Tools\\Microsoft.TeamFoundation.Server.Core.dllC:\\Program Files\\Microsoft Team Foundation Server 12.0\\Tools\\Microsoft.TeamFoundation.VersionControl.Server.dllC:\\Program Files (x86)\\Microsoft Visual Studio 12.0\\Common7\\IDE\\ReferenceAssemblies\\v2.0\\Microsoft.TeamFoundation.WorkItemTracking.Client.dllC:\\Program Files (x86)\\Microsoft Visual Studio 12.0\\Common7\\IDE\\ReferenceAssemblies\\v4.5\\Microsoft.VisualStudio.Services.WebApi.dllЭти сборки содержат необходимые нам объекты, включая интерфейс ISubscriber. Заглушка нашего класса будет выглядеть следующим образом:
public class CodeReviewSubscriber : ISubscriber\n{\n public string Name\n {\n get { return \"Automatic Code Reviews\"; }\n }\n\n public Type[] SubscribedTypes()\n {\n return new Type[] { };\n }\n\n public SubscriberPriority Priority\n {\n get { return SubscriberPriority.Normal; }\n }\n\n public EventNotificationStatus ProcessEvent(TeamFoundationRequestContext requestContext, NotificationType notificationType, object notificationEventArgs, out int statusCode, out string statusMessage, out Microsoft.TeamFoundation.Common.ExceptionPropertyCollection properties)\n {\n // ...\n }\n}Для того, чтобы наш подписчик стал реагировать на комиты, необходимо чтобы метод SubscribedTypes() возвращал соответствующий тип уведомления.
Итого, пустая заглушка будет выглядеть так —
\npublic class CodeReviewSubscriber : ISubscriber\n{\n public string Name\n {\n get { return \"Automatic Code Reviews\"; }\n }\n\n public Type[] SubscribedTypes()\n {\n return new Type[] { typeof(CheckinNotification) };\n }\n\n public SubscriberPriority Priority\n {\n get { return SubscriberPriority.Normal; }\n }\n\n public EventNotificationStatus ProcessEvent(TeamFoundationRequestContext requestContext, NotificationType notificationType, object notificationEventArgs, out int statusCode, out string statusMessage, out Microsoft.TeamFoundation.Common.ExceptionPropertyCollection properties)\n {\n statusCode = 0;\n statusMessage = String.Empty;\n properties = null;\n\n return EventNotificationStatus.ActionPermitted;\n }\n}Добавим логику создания запроса на ревью, получим что-то подобное на это —
\npublic class CodeReviewSubscriber : ISubscriber\n{\n private const string LogFilePath = @\"C:\\log\\tfs.log\";\n private const string ProjectName = @\"TestProject\";\n private const string ReviewerName = @\"Sergey\";\n\n public string Name\n {\n get { return \"Automatic Code Reviews\"; }\n }\n\n public Type[] SubscribedTypes()\n {\n return new[] { typeof(CheckinNotification) };\n }\n\n public SubscriberPriority Priority\n {\n get { return SubscriberPriority.Normal; }\n }\n\n public EventNotificationStatus ProcessEvent(TeamFoundationRequestContext requestContext, NotificationType notificationType, object notificationEventArgs, out int statusCode, out string statusMessage, out Microsoft.TeamFoundation.Common.ExceptionPropertyCollection properties)\n {\n try\n {\n if ((notificationType == NotificationType.Notification) &&\n (notificationEventArgs is CheckinNotification))\n {\n CheckinNotification checkinNotification = (CheckinNotification)notificationEventArgs;\n\n TeamFoundationLocationService tfsService = requestContext.GetService<TeamFoundationLocationService>();\n Uri tfsServiceUri = tfsService.GetSelfReferenceUri(requestContext, tfsService.GetDefaultAccessMapping(requestContext));\n TfsTeamProjectCollection tfsServiceCollection = new TfsTeamProjectCollection(tfsServiceUri);\n\n\n IIdentityManagementService identityManagementService = tfsServiceCollection.GetService<IIdentityManagementService>();\n TeamFoundationIdentity identity = identityManagementService.ReadIdentity(IdentitySearchFactor.AccountName, checkinNotification.ChangesetOwner.UniqueName, MembershipQuery.None, ReadIdentityOptions.None);\n TfsTeamProjectCollection projectCollection = new TfsTeamProjectCollection(tfsServiceCollection.Uri, identity.Descriptor);\n\n WorkItemStore workitemStore = projectCollection.GetService<WorkItemStore>();\n\n Project project = workitemStore.Projects[ProjectName];\n\n CreateReviewRequest(project, checkinNotification, workitemStore);\n }\n }\n catch (Exception ex)\n {\n WriteLog(ex.ToString());\n }\n\n statusCode = 0;\n statusMessage = String.Empty;\n properties = null;\n\n return EventNotificationStatus.ActionPermitted;\n }\n\n private void CreateReviewRequest(Project project, CheckinNotification checkinNotification, WorkItemStore workitemStore)\n {\n WorkItemType type = project.WorkItemTypes[\"Code Review Response\"];\n WorkItem workItem = new WorkItem(type)\n {\n Title = checkinNotification.Comment\n };\n workItem.Fields[\"System.AssignedTo\"].Value = ReviewerName;\n workItem.Fields[\"System.State\"].Value = \"Requested\";\n workItem.Fields[\"System.Reason\"].Value = \"New\";\n\n workItem.Validate();\n workItem.Save();\n\n int workitemId = workItem.Id;\n\n type = project.WorkItemTypes[\"Code Review Request\"];\n workItem = new WorkItem(type) {Title = checkinNotification.Comment};\n workItem.Fields[\"System.AssignedTo\"].Value = checkinNotification.ChangesetOwner.DisplayName;\n workItem.Fields[\"Microsoft.VSTS.CodeReview.ContextType\"].Value = \"Changeset\";\n workItem.Fields[\"Microsoft.VSTS.CodeReview.Context\"].Value = checkinNotification.Changeset;\n workItem.Fields[\"System.AreaPath\"].Value = project.Name;\n workItem.Fields[\"System.IterationPath\"].Value = project.Name;\n workItem.Fields[\"System.State\"].Value = \"Requested\";\n workItem.Fields[\"System.Reason\"].Value = \"New\";\n WorkItemLinkTypeEnd linkTypeEnd = workitemStore.WorkItemLinkTypes.LinkTypeEnds[\"Child\"];\n workItem.Links.Add(new RelatedLink(linkTypeEnd, workitemId));\n\n workItem.Validate();\n\n workItem.Save();\n }\n\n private void WriteLog(string message)\n {\n File.AppendAllText(LogFilePath, message);\n File.AppendAllText(LogFilePath, Environment.NewLine);\n }\n}Этот код далек от совершенства, но показывает суть происходящего процесса.
\nТеперь, когда наш подписчик готов, необходимо вклинить его в процесс работы TFS. Для этого полученную сборку следует поместить в папку C:\\Program Files\\Microsoft Team Foundation Server 12.0\\Application Tier\\Web Services\\bin\\Plugins (на сервере).
Теперь для каждого комита в TFS вы получите запрос на ревью кода.
", "tags": [ "Team Foundation Server", "Visual Studio Team System" ], "banner_image": "https://blog.zwezdin.com/2014/tfs-2013-automatic-code-reviews/d6f310c6/tfs_2013-automatic-code-reviews@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/emitmapper/", "url": "https://blog.zwezdin.com/2013/emitmapper/", "title": "Автоматический маппинг объектов в .NET — Emitmapper", "date_published": "2013-12-25T12:00:00.000Z", "content_html": "Главным отличием EmitMapper от AutoMapper по заявлению разработчиков заключается в использовании механизма Reflection Emit. Этот механизм позволяет строить IL-код на лету использовать его. В результате EmitMapper работает на несколько порядков быстрее.
\nРазработчики EmitMapper написали простенький benchmark, в котором они сравнивают работу EmitMapper, AutoMapper и маппинг объектов руками. Вот что у них получилось на тестовом прогоне:
\nЦифры говорят сами за себя и показывают причину, почему стоит рассмотреть также и EmitMapper.
\nНесмотря на разницу в подходах, AutoMapper и EmitMapper очень похожи в идеологии. Обе библиотеки выполняют маппинг одного объекта в другой.
\nЧтобы работать с EmitMapper, установим в проект библиотеку:
\nInstall-Package EmitMapperОсновным объектом, с которым мы будем работать - ObjectMapperManager.
Используем для работы всё те же объекты —
\npublic class UserDto\n{\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n public string Email { get; set; }\n\n}\n\npublic class User\n{\n public string FullName { get; set; }\n\n public string Email { get; set; }\n}Настроим конфигурацию:
\nDefaultMapConfig config = new DefaultMapConfig();\nconfig.ConvertUsing((UserDto source) =>\n new User\n {\n FullName = source.FirstName + \" \" + source.LastName,\n Email = source.Email\n });Тогда маппинг можно выполнить так:
\nvar user = ObjectMapperManager\n .DefaultInstance\n .GetMapper<UserDto, User>(config)\n .Map(new UserDto\n {\n FirstName = \"Ivan\",\n LastName = \"Ivanov\",\n Email = \"ivan@ivanon.ru\"\n });Как видно, синтаксис предельно похож на синтаксис AutoMapper’а.
\nНа практике, лучше всего создать слой абстракции, чтобы не зависеть от конкретной реализации маппера.
", "tags": [ "C#", ".NET" ], "banner_image": "https://blog.zwezdin.com/2013/emitmapper/475b74ac/emitmapper@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/how-to-setup-nuget-server/", "url": "https://blog.zwezdin.com/2013/how-to-setup-nuget-server/", "title": "Как настроить собственный Nuget-сервер", "date_published": "2013-12-23T12:00:00.000Z", "content_html": "Многие компании сталкиваются с необходимостью иметь собственный локальный Nuget-сервер для хостинга внтуренних разработок и фреймворков. Одним из наиболее простых вариантов является общая сетевая папка, где могут хранится все пакеты. Однако, это не всегда удобно и более правильным решением будет хостинг веб-приложения, которое и будет выполнять роль Nuget-сервера.
\nЧтобы создать Nuget-сервер необходимо выполнить несколько несложных шагов.
\nДля начала создадим новое пустое ASP.NET приложение и установим в него пакет NuGet.Server.
Install-Package NuGet.ServerЗаготовка для нашего Nuget-сервера готова.
\nПеред использованием Nuget, необходимо задать несколько параметров в конфигурационном файле web.config. Все параметры определены в секции appSettings.
Один из обязательных параметров - это packagesPath, он указывает на папку, в которой будут хранится все пакеты для данного сервера.
<appSettings>\n <add key=\"apiKey\" value=\"C:\\Packages\\\" />\n</appSettings>Другие два важных параметра —
\nrequireApiKey, который указывает на необходимость предоставления ключа для управления пакетами на сервере. Если этот параметр установлен в true, то сервер в обязательном порядке будет требовать предоставление ключа.apiKey - собственно, сам ключ, который будет использоваться для взаимодействия с сервером. Если флаг requireApiKey будет установлен в true, а значение apiKey будет пустым, то публикация пакетов на сервер будет заблокирована.<appSettings>\n <add key=\"requireApiKey\" value=\"true\" />\n <add key=\"apiKey\" value=\"1ab183523cx7usf\" />\n</appSettings>Наш Nuget-сервер готов и его можно запускать как обычное ASP.NET приложение.
\nПри запуске приложения локально, можно обратиться по адресу http://localhost:[port]/nuget и получить текущую ленту пакетов.
Для публикации своих пакетов на сервер можно воспользоваться следующим синтаксисом утилиты nuget.exe:
nuget push {package file} -s http://localhost:[port]/ {apikey}Когда сервер настроен и протестирован, его следует опубликовать на сервер IIS. Процедура публикации не отличается от любого другого веб-приложения. Например, вы можете воспользоваться встроенным средством публикации веб-приложений в Visual Studio.
\nТеперь, для того, чтобы использовать только что созданный сервер в Visual Stuido, необходимо в настройках VS указать адрес этого Nuget-сервера. Для этого следует открыть настройки в меню Visual Studio Tools → Options → Package Manager → Package Sources и добавить там адрес только что созданного Nuget-сервера.
Ваш собственный Nuget-сервер готов к использованию.
", "tags": [ "Nuget" ], "banner_image": "https://blog.zwezdin.com/2013/how-to-setup-nuget-server/42e5fab9/how_to-setup-nuget-server@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/automapper/", "url": "https://blog.zwezdin.com/2013/automapper/", "title": "Автоматический маппинг объектов в .NET — Automapper", "date_published": "2013-12-07T12:00:00.000Z", "content_html": "При разработке приложений частенько приходится сталкиваться с задачей преобразования одного объекта в другой. Этот процесс можно немного облегчить используя уже готовые библиотеки. Здесь я приведу пример на основе уже достаточно известной библиотеки Automapper.
\nПрежде чем приступить к рассмотрению маппига, хочу привести несколько ситуаций когда это может потребоваться:
\nИными словами маппинг нужен там, где объект переходит за границы приложения/уровня/слоя/компонента/…
\nДля того, чтобы начать использовать automapper, установим библиотеку из Nuget:
\nInstall-Package AutoMapperДля эксперимента создадим два объекта - UserDto и User.
public class UserDto\n{\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n public string Email { get; set; }\n\n}\n\npublic class User\n{\n public string FullName { get; set; }\n\n public string Email { get; set; }\n}При маппинге из UserDto в User, нам нужно заполнить поле FullName путем объединения свойств FirstName и LastName исходного объекта.
Используя объект Mapper, создадим конфигурацию маппера:
Mapper.CreateMap<UserDto, User>()\n .ForMember(x => x.FullName,\n x => x.MapFrom(m => m.FirstName + \" \" + m.LastName))\n .ForMember(x => x.Email,\n x => x.MapFrom(m => m.Email));Запись эта интуитивно понятна и задает правила каким образом нужно маппить один объект в другой.
\nМаппинг выполняется также в одну строчку:
\nUser user = Mapper.Map<User>(new UserDto\n{\n FirstName = \"Ivan\",\n LastName = \"Ivanov\",\n Email = \"ivan@ivanon.ru\"\n});Что интересно, в данном примере правило маппинга для свойства Email избыточно, поскольку Automapper сам сопоставляет поля по имени и типу. Соответственно это правила можно переписать следующим образом:
Mapper.CreateMap<UserDto, User>()\n .ForMember(x => x.FullName,\n x => x.MapFrom(m => m.FirstName + \" \" + m.LastName));Результат при этом не изменится.
\nЭто самый простой способ использования библиотеки Automapper, вот более полный список возможностей библиотеки:
\nСледует отметить, что регистрация правил действует в рамках домена приложения (AppDomain). Если ваше приложение использует несколько доменов, то в каждом из них следует зарегистрировать эти правила.
При получении HTTP-запроса к несуществующему действию контроллера ASP.NET MVC, можно по-разному обрабатывать эту ситуацию. Одним из вариантов является переопределение метода HandleUnknownAction.
Допустим в нашем приложении есть контроллер:
\npublic class HomeController : Controller\n{\n public ActionResult Index()\n {\n return View();\n }\n}При стандартной настройке маршрутов мы можем обратиться к контроллеру по адресу /home/index и страница отобразится пользователю.
В случае, если мы обратимся по адресу, соответствующему несуществующему контроллеру, мы получим HTTP 404.
Чтобы исправить эту ситуацию, переопределим метод HandleUnknownAction для данного контроллера:
public class HomeController : Controller\n{\n public ActionResult Index()\n {\n return View();\n }\n\n protected override void HandleUnknownAction(string actionName)\n {\n View(\"Index\").ExecuteResult(ControllerContext);\n }\n}При такой реализации, обращаясь к несуществующему действию, мы получим страницу Index. Каким образом построить дальнейшую логику будет зависеть от конкретного приложения.
", "tags": [ "ASP.NET" ], "banner_image": "https://blog.zwezdin.com/2013/handle-unknown-actions-at-aspnet-mvc/f764e161/handle_unknown-actions-at-aspnet-mvc@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/pretty-urls-for-aspnet-mvc-apps/", "url": "https://blog.zwezdin.com/2013/pretty-urls-for-aspnet-mvc-apps/", "title": "Красивые URL в приложениях ASP.NET MVC", "date_published": "2013-10-26T12:00:00.000Z", "content_html": "Каждому разработчику на ASP.NET MVC известно, что платформа имеет мощную и удобную систему определения маршрутов в приложении. На основе этих маршрутов выбираются подходящие контроллеры и действия, а также генерируются адреса (URL) внтури приложения. Что меня всегда угнетало, это то, что имена контроллеров/действий используются генерируются в адресе “как есть”. В итоге пользователь видит что-то уродливое вроде http://myapp.ru/Contacts/List. Рассмотрим способ как это можно исправить.
В данном случае речь идет об адресах, которые мы генерируем в представлениях при использовании стандартных классов-хелперов, например таким образом:
\n<a href=\"@Url.Action(\"List\",\"Contacts\")\">Contacts</a>Как по мне, так URL в нижнем регистре выглядят более привлекательно. Говорят, так же, что это важно для поисковой оптимизации (SEO).
\nСуществует два способа решения проблемы — простой (доступный в .NET 4.5 и выше) и сложный (доступный до версии 4.5).
\nРешение указанной проблемы в .NET 4.5 лежит на поверхности. Для этого при определении маршрутов достаточно установить свойство LowercaseUrls в true у объекта RouteCollection. В дополнение в .NET 4.5 появилась опция AppendTrailingSlash, при помощи которой мы можем принудительно добавлять слеш в конце.
public static void RegisterRoutes(RouteCollection routes)\n{\n routes.IgnoreRoute(\"{resource}.axd/{*pathInfo}\");\n\n routes.MapRoute(\n name: \"Default\",\n url: \"{controller}/{action}/{id}\",\n defaults: new { controller = \"Home\", action = \"Index\", id = UrlParameter.Optional }\n );\n\n routes.LowercaseUrls = true;\n routes.AppendTrailingSlash = true;\n}В этом случае все немного сложнее, поскольку в то время эта функциональность ещё не была реализована. Решением является реализация этого механизма самостоятельно.
\nКак известно, в коллекцию RouteCollection добавляются объекты типа Route, которые и содержат информацию о маршруте. Переопределив поведение этого объекта, можно влиять на то, как будут генерироваться URL. Создадим такой класс:
public class LowercaseRoute : System.Web.Routing.Route\n{\n public LowercaseRoute(string url, IRouteHandler routeHandler)\n : base(url, routeHandler)\n {\n }\n\n public LowercaseRoute(string url, RouteValueDictionary defaults, IRouteHandler routeHandler)\n : base(url, defaults, routeHandler)\n {\n }\n\n public LowercaseRoute(string url, RouteValueDictionary defaults, RouteValueDictionary constraints,\n IRouteHandler routeHandler)\n : base(url, defaults, constraints, routeHandler)\n {\n }\n\n public LowercaseRoute(string url, RouteValueDictionary defaults, RouteValueDictionary constraints,\n RouteValueDictionary dataTokens, IRouteHandler routeHandler)\n : base(url, defaults, constraints, dataTokens, routeHandler)\n {\n }\n\n public override VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary values)\n {\n VirtualPathData path = base.GetVirtualPath(requestContext, values);\n\n if (path != null)\n path.VirtualPath = path.VirtualPath.ToLowerInvariant();\n\n return path;\n }\n}Теперь можно добавить этот маршрут в коллекцию RouteCollection простым вызовом метода Add. Чтобы это можно было делать как и раньше (путем вызова метода MapRoute) создадим расширение для RouteCollection.
public static class LowercaseRouteExtensions\n{\n public static Route MapRouteLowercase(this RouteCollection routes,\n string name, string url, object defaults)\n {\n var route = new LowercaseRoute(url,\n CreateRouteValueDictionary(defaults),\n new MvcRouteHandler());\n\n routes.Add(route);\n\n return route;\n }\n\n private static RouteValueDictionary CreateRouteValueDictionary(object values)\n {\n IDictionary<string object=\"\" ,=\"\"> dictionary = values as IDictionary<string object=\"\" ,=\"\">;\n\n if (dictionary != null)\n {\n return new RouteValueDictionary(dictionary);\n }\n\n return new RouteValueDictionary(values);\n }\n}Всё, что делает MapRouteLowercase - это создает новый объект-наследник Route и добавляет его в RouteCollection. Этот класс можно расширить и другими методами с различным количеством параметров. Это не трудно сделать, поэтому полный листинг здесь не привожу.
Настройка маршрутов теперь должна быть выполнена теперь при помощи только что созданного метода MapRouteLowercase.
public static void RegisterRoutes(RouteCollection routes)\n{\n routes.IgnoreRoute(\"{resource}.axd/{*pathInfo}\");\n\n routes.MapRouteLowercase(\n name: \"Default\",\n url: \"{controller}/{action}/{id}\",\n defaults: new { controller = \"Home\", action = \"Index\", id = UrlParameter.Optional }\n );\n}Теперь наши приложения будут иметь красивые URL и чуть более дружественны к поисковой оптимизации.
", "tags": [ "ASP.NET" ], "banner_image": "https://blog.zwezdin.com/2013/pretty-urls-for-aspnet-mvc-apps/b91a702e/pretty_urls-for-aspnet-mvc-apps@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/stack-trace/", "url": "https://blog.zwezdin.com/2013/stack-trace/", "title": "Обработка стека вызова исключения .NET", "date_published": "2013-09-30T12:00:00.000Z", "content_html": "При генерации исключения в .NET мы имеем достаточно подробную информацию о том, что произошло. Одна из важнейших частей — стек вызовов. В самом исключении стек вызовов представлен в виде строки. Однако, в .NET существует объект StackTrace, который позволяет работать со стеком вызовов более удобно.
Чтобы обработать стек вызовов, при перехвате исключения создадим объект StackTrace, в конструкторе которого передадим исключение. В этом случае мы сможем отследить все шаги, которые предшествовали генерации исключения.
Чтобы посмотреть как это работает создадим класс-заглушку, который будет генерировать для нас исключение.
\npublic static class SomeWorker\n{\n public static void Start()\n {\n DoSomething1();\n }\n public static void DoSomething1()\n {\n DoSomething2();\n }\n public static void DoSomething2()\n {\n DoSomething3();\n }\n public static void DoSomething3()\n {\n DoSomething4();\n }\n public static void DoSomething4()\n {\n DoSomething5();\n }\n public static void DoSomething5()\n {\n throw new ArgumentException();\n }\n}Чтобы обработать стек вызовов, при перехвате исключения создадим объект StackTrace, в конструкторе которого передадим исключение. В этом случае мы сможем отследить все шаги, которые предшествовали генерации исключения.
try\n{\n SomeWorker.Start();\n}\ncatch (Exception ex)\n{\n var stack = new StackTrace(ex);\n foreach (StackFrame frame in stack.GetFrames())\n {\n Console.WriteLine(frame.GetMethod());\n }\n}![\"Обработка](\"https://blog.zwezdin.com/2013/stack-trace/46ac9ead/1@2x.png\")
\n\n\n\n\nИспользование объекта StackTrace бывает удобно, если вы пытаетесь анализировать ошибки более глубоко и системно. Например, таким образом можно собрать информацию по всем классам/методам, которые больше всего подвержены генерации необработанных исключений.
Какое неудобство настигает нас при отладке приложения в Visual Studio? Для меня всегда было неудобно осуществлять навигацию по свойствам объекта, когда нужна какая-то информация. В этой статье я приведу набор атрибутов, которые позволяют упростить данный процесс.
\nДля того, чтобы упростить этот процесс можно использовать набор предопределенных атрибутов.
\nDebuggerDisplayПозволяет задать строку для класса или свойства, которая будет отображаться в отладчике.
\npublic class Person\n{\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n public int Age { get; set; }\n}По умолчанию, при просмотре значения отладчик отобразит полное название класса:
\n\n\n\n![\"Изменение](\"https://blog.zwezdin.com/2013/visual-studio-debugger/1b9a79b0/1@2x.png\")
\n\n\n\n\nДобавим атрибут DebuggerDisplay:
[DebuggerDisplay(\"{FirstName} {LastName}, {Age} years old\")]\npublic class Person\n{\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n public int Age { get; set; }\n}Тогда отображение в отладчике изменится следующим образом:
\n\n\n\n![\"Изменение](\"https://blog.zwezdin.com/2013/visual-studio-debugger/b0ef4365/2@2x.png\")
\n\n\n\n\nАналогичным образом можно настроить отображение значений свойств:
\n[DebuggerDisplay(\"{FirstName} {LastName}, {Age} years old\")]\npublic class Person\n{\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n [DebuggerDisplay(\"{Age} years old\")]\n public int Age { get; set; }\n}![\"Изменение](\"https://blog.zwezdin.com/2013/visual-studio-debugger/3b1e236c/3@2x.png\")
\n\n\n\n\nDebuggerBrowsableПозволяет управлять поведением отладчика, при отображении свойства. В конструкторе должен передаваться параметр DebuggerBrowsableState, который принимает одно из следующих состояний:
На практике использование этого атрибута выглядит так:
\npublic class Person\n{\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n [DebuggerBrowsable(DebuggerBrowsableState.Never)]\n public int Age { get; set; }\n\n [DebuggerBrowsable(DebuggerBrowsableState.RootHidden)]\n public string[] Phones { get; set; }\n}![\"Изменение](\"https://blog.zwezdin.com/2013/visual-studio-debugger/69c04fee/4@2x.png\")
\n\n\n\n\nDebuggerTypeProxyЭтот способ позволяет более радикально изменить способ отображения информации об объекте.
\nДля того, чтобы использовать атрибут DebuggerTypeProxy, необходимо создать класс, принимающий в конструкторе отображаемый объект. Свойства этого класса и будут отображаться в отладчике вместо оригинального класса. При этом содержимое исходного класса будет отображаться в ветке Raw View.
[DebuggerTypeProxy(typeof(PersonVisualizer))]\npublic class Person\n{\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n public int Age { get; set; }\n}\n\npublic class PersonVisualizer\n{\n private readonly Person _person;\n\n public PersonVisualizer(Person person)\n {\n _person = person;\n }\n\n public string FullName\n {\n get { return _person.FirstName + \" \" + _person.LastName; }\n }\n}![\"Изменение](\"https://blog.zwezdin.com/2013/visual-studio-debugger/f2518b85/5@2x.png\")
\n\n\n\n\nDebuggerVisualizerЕсли все предыдущие способы позволяли повлиять на отображение значения в окне самого отладчика, то этот способ позволяет определить собственный пользовательский интерфейс для отображения данных. Такой способ может быть полезен при отображении сложных типов.
\nДля того, чтобы воспользоваться этим способом, необходимо подключить к проекту сборку Microsoft.VisualStudio.DebuggerVisualizers.
Следующим шагом будет создание объекта, ответственного за отображение отладочной информации. Для этого нужно создать класс-наследник DialogDebuggerVisualizer. В этом классе следует переопределить метод Show, который принимает контекст для отображения окна, а также объект, позволяющий получить доступ к исходному объекту.
public class PersonVisualizer : DialogDebuggerVisualizer\n{\n protected override void Show(IDialogVisualizerService windowService, IVisualizerObjectProvider objectProvider)\n {\n\n }\n}Здесь есть одно ограничение, которое накладывается на исходный объект - он должен быть сериализуемый (помечен атрибутом Serializable), для того, чтобы его можно было переслать за рамки приложения. Внутри метода Show пишем код для создания пользовательского интерфейса и отображаем данные:
public class PersonVisualizer : DialogDebuggerVisualizer\n{\n protected override void Show(IDialogVisualizerService windowService, IVisualizerObjectProvider objectProvider)\n {\n Person data = (Person)objectProvider.GetObject();\n\n Form form = new Form();\n\n form.Controls.Add(new Label\n {\n Dock = DockStyle.Top,\n Text = data.FirstName\n });\n\n form.Controls.Add(new Label\n {\n Dock = DockStyle.Top,\n Text = data.LastName\n });\n\n form.Controls.Add(new Label\n {\n Dock = DockStyle.Top,\n Text = data.Age.ToString()\n });\n\n windowService.ShowDialog(form);\n }\n}Последнее - сообщаем компилятору о том, какой класс отладчик может использовать для отображения информации об объекте:
\n[DebuggerVisualizer(typeof(PersonVisualizer))]\n[Serializable]\npublic class Person\n{\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n public int Age { get; set; }\n}Теперь при запуске отладчика, напротив значения появится кнопка.
\n\n\n\n![\"Изменение](\"https://blog.zwezdin.com/2013/visual-studio-debugger/4403087c/6@2x.png\")
\n\n\n\n\nПри нажатии на ней отобразится созданная форма.
\n\n\n\n![\"Изменение](\"https://blog.zwezdin.com/2013/visual-studio-debugger/ca8c4b71/7@2x.png\")
\n\n\n\n\nDebuggerHidden и DebuggerStepThroughПозволяет скрыть от отладчика код при выполнении пошаговой отладки.
\nЕсли вы установите точку останова в методе, помеченноматрибутом DebuggerHidden, то точка останова не сработает. Аналогичное поведение будет при использовании команды отладчика Step Into.
При использовании атрибута DebuggerStepThrough, точки останова будут срабатывать, но команда отладчика Step Into будет игнорировать метод.
public class Person\n{\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n public int Age { get; set; }\n\n [DebuggerHidden]\n public void Print()\n {\n }\n\n [DebuggerStepThrough]\n public void Display()\n {\n }\n}Аналогично можно работать с get- и set-методами свойств.
\nConditionalЭтот атрибут не относится к отладчику, а скорее влияет на компиляцию кода, но также бывает полезным при отладке.
\nЭтим атрибутом можно разметить метод и указать некоторое условие, аналогично тому, как это делается в директивах препроцессора. Если условие сработало, то указанный метод выполнится; если нет, то метод будет исключен при компиляции кода.
\nНапример, следующий метод будет запускаться только в случае, если приложение построено в конфигурации Debug:
public class Person\n{\n public string FirstName { get; set; }\n\n public string LastName { get; set; }\n\n public int Age { get; set; }\n\n [Conditional(\"DEBUG\")]\n public void Print()\n {\n Console.WriteLine(LastName);\n }\n}Существуют ограничения, которые накладываются на методы, с которыми может использоваться указанный атрибут:
\nvoid.Эти нехитрые инструменты позволят чувствовать себя более комфортно при отладке кода. Особенно полезно использовать данные приемы, если вы разрабатываете код, который будет повторно использоваться многократно.
", "tags": [ "C#", ".NET", "Visual Studio" ], "banner_image": "https://blog.zwezdin.com/2013/visual-studio-debugger/d1527e16/visual_studio-debugger@cover.png" }, { "id": "https://blog.zwezdin.com/2013/ajax-errors-handling-aspnet-mvc/", "url": "https://blog.zwezdin.com/2013/ajax-errors-handling-aspnet-mvc/", "title": "Корректная обработка проблем аутентификации AJAX-запросов для приложений ASP.NET MVC", "date_published": "2013-09-18T12:00:00.000Z", "content_html": "Для современных веб-приложений стало уже нормой использование AJAX при создании пользовательских интерфейсов. Однако, из-за этого, порой, возникают дополнительные сложности. Часто эти сложности связаны с аутентификацией и процессом обработки таких запросов на клиенте.
\nПредположим, что наше веб-приложение при помощи jQuery обращается к серверу и получает оттуда данные в виде JSON.
\nСервер:
\n[HttpPost]\npublic ActionResult GetData()\n{\n return Json(new\n {\n Items = new[]\n {\n \"Li Chen\",\n \"Abdullah Khamir\",\n \"Mark Schrenberg\",\n \"Katy Sullivan\",\n \"Erico Gantomaro\",\n }\n });\n}Клиент:
\nvar $list = $(\"#list\");\nvar $status = $(\"#status\");\n$list.empty();\n$status.text(\"Loading...\");\n\n$.post(\"/home/getdata\")\n .always(function() {\n $status.empty();\n })\n .success(function(data) {\n for (var i = 0; i < data.Items.length; i++) {\n $list.append($(\"<li/>\").text(data.Items[i]));\n }\n });Логика предельно простая и понятная. Теперь добавим в наше приложение механизмы аутентификации. С этим опять-таки все довольно просто – пользуемся старым-добрым механизмом FormsAuthentication и атрибутом Authorize в ASP.NET MVC. Код нашего контроллера при этом поменяется так:
[HttpPost]\n[Authorize]\npublic ActionResult GetData()\n{\n return Json(new\n {\n Items = new[]\n {\n \"Li Chen\",\n \"Abdullah Khamir\",\n \"Mark Schrenberg\",\n \"Katy Sullivan\",\n \"Erico Gantomaro\",\n }\n });\n}Опять же – проблем с этим кодом нет. После аутентификации пользователь видит страницу и может получать данные как и раньше. Однако, проблема в том, что если время аутентификации истечёт (из-за неактивности пользователя) или пользователь выйдет из системы (например, в другой вкладке браузера), то сервер в ответ на обращение к действию контроллеру вернет.. HTTP 302 Found.
![\"Корректная](\"https://blog.zwezdin.com/2013/ajax-errors-handling-aspnet-mvc/0132fb1b/1@2x.png\")
\n\n\n\n\nОчевидно, что клиентский код в нашем случае не ожидал такого поворота событий и дальше приложение будет работать некорректно.
\nПрежде чем решать проблему, давайте разберемся с причинами – откуда появилось HTTP 302? Казалось бы - причем здесь 302? Было бы логично допустить, что там должно быть HTTP 401. Дело в том, что когда мы пользуемся FormsAuthentication за сценой действует FormsAuthenticationModule (который добавляется в список HTTP-модулей в глобальном конфигурационном файле). Заглянув под капот этого модуля можно легко понять, что если текущий код для HTTP есть 401, то он выполняет редирект, т.е. заменяет его на 302:
![\"Корректная](\"https://blog.zwezdin.com/2013/ajax-errors-handling-aspnet-mvc/ad2c0035/2@2x.png\")
\n\n\n\n\nНетрудно догадаться, что сделано это было с целью перенаправить пользователя на страницу ввода пароля, если запрос не обработан успешно и требуется указать пароль (код возврата - 401). В этом случае пользователь увидит приветливую форму ввода пароля, а не страницу IIS с кодом ошибки. Имеет смысл, не правда ли?
С точки зрения нашего ASP.NET MVC приложения цепочка получается такой:
\nHTTP 401, что логично (убедиться в этом достаточно легко, взглянув рефлектором на реализацию этого фильтра).FormsAuthenticationModule, который подменяет 401 на редирект.В итоге – при обращении к защищенной паролем странице мы видим форму ввода пароля (что хорошо), но при обращении к аналогичным ресурсам через AJAX этот ответ не информативен (что плохо).
\nИтак, что нужно для решения проблемы —
\n401/403 для AJAX-запросов, и 302 для обычных запросов.401/403.Честно говоря, FormsAuthenticationModule можно заставить не заменять запросы с 401. Для этого в HttpResponse есть специальное свойство – SuppressFormsAuthenticationRedirect:
![\"Корректная](\"https://blog.zwezdin.com/2013/ajax-errors-handling-aspnet-mvc/be202625/3@2x.png\")
\n\n\n\n\nВопрос только в том, в каких случаях изменять это свойство и, что не менее важно, кто именно это будет делать?
\nПрежде чем ответить на этот вопрос, давайте обратим внимание на то, как клиент должен реагировать, когда получает HTTP-ответ с ошибкой в ответ на AJAX-запрос. Сценария может быть два:
\n401) и его нужно отправить на страницу с вводом логина пароля.403). Например, мы можем разрешить какое-то действие для определенных ролей, в которые пользователь не входит. Тогда отправлять его на страницу ввода пароля, пожалуй, глупо – в этом случае будет достаточным просто сообщить ему о том, что у него недостаточно полномочий.Таким образом нам нужно обрабатывать две ситуации по-разному. Взглянем рефлектором ещё раз на AuthorizeAttribute.
![\"Корректная](\"https://blog.zwezdin.com/2013/ajax-errors-handling-aspnet-mvc/4dc81de3/4@2x.png\")
\n\n\n\n\n…т.е. он всегда возвращает 401.
Нехорошо. Поэтому придется немного поправить стандартное поведение. Итак, начнем.
\nПервое — определим, является ли текущий запрос AJAX-запросом и если да, то отключаем редирект на страницу ввода пароля:
\npublic class ApplicationAuthorizeAttribute : AuthorizeAttribute\n{\n protected override void HandleUnauthorizedRequest(AuthorizationContext filterContext)\n {\n var httpContext = filterContext.HttpContext;\n var request = httpContext.Request;\n var response = httpContext.Response;\n\n if (request.IsAjaxRequest())\n response.SuppressFormsAuthenticationRedirect = true;\n\n base.HandleUnauthorizedRequest(filterContext);\n }\n}Второе – добавляем условие: если пользователь аутентифицирован, то отдаем 403, если нет, то 401:
public class ApplicationAuthorizeAttribute : AuthorizeAttribute\n{\n protected override void HandleUnauthorizedRequest(AuthorizationContext filterContext)\n {\n var httpContext = filterContext.HttpContext;\n var request = httpContext.Request;\n var response = httpContext.Response;\n var user = httpContext.User;\n\n if (request.IsAjaxRequest())\n {\n if (user.Identity.IsAuthenticated == false)\n response.StatusCode = (int)HttpStatusCode.Unauthorized;\n else\n response.StatusCode = (int)HttpStatusCode.Forbidden;\n\n response.SuppressFormsAuthenticationRedirect = true;\n response.End();\n }\n\n base.HandleUnauthorizedRequest(filterContext);\n }\n}Новый фильтр готов. Теперь нам следует использовать только что созданный фильтр в нашем приложении, вместо стандартного AuthorizeAttribute. Эстетам это может показаться огромным недостатком, но другого пути я здесь не вижу. Если есть решение, то буду рад увидеть его в комментариях.
\nНу и последнее, что нужно сделать – добавить обработку 401/403 на клиенте. Чтобы это не делать этого для каждого запроса можно воспользоваться обработчиком ajaxError в jQuery:
$(document).ajaxError(function (e, xhr) {\n if (xhr.status == 401)\n window.location = \"/Account/Login\";\n else if (xhr.status == 403)\n alert(\"You have no enough permissions to request this resource.\");\n});В итоге –
\nИз минусов – необходимо использовать новый фильтр ApplicationAuthorizeAttribute, вместо стандартного. Соответственно, если в коде стандартный уже использовался, то этот код придется поменять во всех местах.
Существует такая отличная штука LESS — надстройка над CSS, которая позволяет создавать стили для своего сайта более удобно, сохраняя при этом код в более аккуратном и поддерживаемом виде.
\nПоскольку изначально процессинг LESS написан на JavaScript, то актуальным остается вопрос каким образом интегрировать процессинг LESS-документов в проект ASP.NET. Здесь я рассмотрю известные мне способы.
\nСамый простой способ интеграции – использовать клиентский процессинг LESS. Этот способ также предлагают разработчики LESS на своем сайте.
\nДля подключения LESS на клиенте нужно выполнить два шага:
\nШаг 1: Добавить ссылки на LESS-файлы
\n<link rel=\"stylesheet/less\" type=\"text/css\" href=\"styles.less\" />Шаг 2: Добавить ссылку на JavaScript-сценарий less.js с официального сайта:
\n<script src=\"less.js\" type=\"text/javascript\"></script>В этом случае при загрузке страницы будет загружен JavaScript-сценарий для процессинга, файлы LESS, а также дополнительные файлы, если потребуется (ссылки на другие скрипты, изображения и т.д.).
\nПлюсы данного подхода:
\nМинусы данного подхода:
\nВыводы — данный способ подходит разве что для процесса разработки, когда LESS-код постоянно изменяется. На живый проектах использование данного способа весьма сомнительно. В моем случае минусы перекрывают все плюсы, поэтому я в своей работе не использую данный способ вообще.
\nСуществует такое прекрасное расширение для Visual Studio - Web Essentials 2012. Это расширение добавляет много различных полезных вещей для веб-разработчика. Если вы не знакомы с этим расширением, очень рекомендую его посмотреть.
\nВ контексте текущей темы, это расширение полезно с точки зрения работы с LESS. Оно может генерировать CSS-стили при сохранении LESS-файлов и при сборке проекта. Для этого после установки расширения нужно открыть окно настроек: Tools → Options → Web Essentials → LESS и задать соответствующие настройки.
![\"Интеграция](\"https://blog.zwezdin.com/2013/less-integration-into-aspnet/d1771769/1@2x.png\")
\n\n\n\n\nТеперь можно добавить LESS-файл в проект и, если вы задали настройку Show preview window, то генерация CSS будет происходить “на лету”:
![\"Интеграция](\"https://blog.zwezdin.com/2013/less-integration-into-aspnet/d051e2da/2@2x.png\")
\n\n\n\n\nПосле генерации CSS-файлы также доступны в проекте:
\n\n\n\n![\"Интеграция](\"https://blog.zwezdin.com/2013/less-integration-into-aspnet/cbe0b3b8/3@2x.png\")
\n\n\n\n\nВ целом, в таком режиме работать очень удобно – сразу видишь генерируемый код.
\nНо пока этот способ у меня, к сожалению, не прижился. Не уверен почему так происходит, но Web Essentials часто отказывается обрабатывать, казалось бы, корректный LESS-документ. Например, если в предыдущем примере переместить переменную в начало документа, то Web Essentials поругается на такой документ:
\n\n\n\n![\"Интеграция](\"https://blog.zwezdin.com/2013/less-integration-into-aspnet/ecf08e51/4@2x.png\")
\n\n\n\n\nРасчитывать на то, что будут обрабатываться какие-то уже готовые LESS-документы (например, LESS из Twitter Bootstrap) и вовсе не приходится, увы.
\nПлюсы данного подхода:
\nМинусы данного подхода:
\nВыводы – способ очень интересный и перспективный, но пока сырой. В моем случае использовать его не получается из-за постоянных ошибок процессинга.
\nБиблиотека dotless – это просто находка для .NET-окружения. Она предоставляет множество различных способов генерировать CSS на основе LESS в среде .NET. При этом существует вариант генерации CSS в момент выполнения приложения (есть готовый ASP.NET HTTP-handler), прямо из .NET-кода, а также при помощи консольной утилиты.
\nЧтобы не тратить время на генерацию CSS в момент исполнения, я предпочитаю получать CSS в момент сборки проекта. Поэтому в моем случае работает следующее решение. Сразу скажу, что в данном случае при создании проекта придется немного поработать руками – а именно подключить процессинг LESS-файлов через консольную утилиту.
\nШаг 1: Создаем проект и добавляем в него LESS-файлы.
\n\n\n\n![\"Интеграция](\"https://blog.zwezdin.com/2013/less-integration-into-aspnet/73d3d116/5@2x.png\")
\n\n\n\n\nШаг 2: Подключаем dotless. Можно загрузить его с официального сайта, либо подключить через nuget.
\n\n\n\n![\"Интеграция](\"https://blog.zwezdin.com/2013/less-integration-into-aspnet/0c8ffaec/6@2x.png\")
\n\n\n\n\nШаг 3: Генерируем CSS при помощи dotless в момент сборки проекта.
\nДля генерации CSS нам придется немного поработать руками. Для этого открываем файл проекта (.csproj) и в самом конце файла, перед закрытием элемента <Project> добавляем новый Target и запускаем его после (можно перед) сборкой:
<Target Name=\"CompileDotlessCss\" AfterTargets=\"AfterBuild\">\n <ItemGroup>\n <__LessFiles Include=\"**\\*.less\"/>\n </ItemGroup>\n <Exec Command=\"\"..\\packages\\dotless.1.3.1.0\\tool\\dotless.compiler.exe\" -m -a \"%(__LessFiles.FullPath)\" \"$([System.String]::Copy('%(__LessFiles.FullPath)').Replace('.less','.min.css'))\"\" />\n <Exec Command=\"\"..\\packages\\dotless.1.3.1.0\\tool\\dotless.compiler.exe\" -a \"%(__LessFiles.FullPath)\" \"$([System.String]::Copy('%(__LessFiles.FullPath)').Replace('.less','.css'))\"\" />\n</Target>Этот небольшой скрипт запускает консольную утилиту dotless при сборке проекта и генерирует файлы .css и .min.css. Откроем проект, запустим сборку, видим появившиеся файлы CSS:
![\"Интеграция](\"https://blog.zwezdin.com/2013/less-integration-into-aspnet/a10637a9/7@2x.png\")
\n\n\n\n\nОчевидно, что в такой иерархии хранить генерируемые CSS очень неудобно – даже при небольшом их количестве в папке будет хаос. Поэтому еще немного поработаем руками.
\nОткрываем файл проекта, находим сгенерированные файлы CSS и декларируем, что они должны отображаться в качестве дочернего узла в дереве проекта:
\n\n\n\n![\"Интеграция](\"https://blog.zwezdin.com/2013/less-integration-into-aspnet/1443e89e/8@2x.png\")
\n\n\n\n\nЗагружаем проект, теперь видим, что всё по полочкам:
\n\n\n\n![\"Интеграция](\"https://blog.zwezdin.com/2013/less-integration-into-aspnet/b99a4cfa/9@2x.png\")
\n\n\n\n\nСовершенству нет предела – давайте немного улучшим этот способ так, чтобы CSS генерировался не для всех LESS файлов, а выборочно. Сделаем так, чтобы процессинг происходил только для тех LESS-файлов, для которых уже существует CSS-файл. Тогда, чтобы добавить процессинг очередного LESS-файла, просто создадим для него пустой CSS-файл и при сборке будет осуществляться процессинг.
\nДля этого идем в файл проекта и изменяем скрипт следующим образом:
\n<Target Name=\"CompileDotlessCss\" AfterTargets=\"AfterBuild\">\n <ItemGroup>\n <__LessFiles Include=\"**\\*.less\" />\n <__LessFilesToProcessMin Include=\"%(__LessFiles.Identity)\" Condition=\"Exists('%(__LessFiles.RootDir)%(__LessFiles.Directory)%(__LessFiles.Filename).min.css')\" />\n <__LessFilesToProcessDev Include=\"%(__LessFiles.Identity)\" Condition=\"Exists('%(__LessFiles.RootDir)%(__LessFiles.Directory)%(__LessFiles.Filename).css')\" />\n </ItemGroup>\n <Exec Command=\"\"..\\packages\\dotless.1.3.1.0\\tool\\dotless.compiler.exe\" -m -a \"%(__LessFilesToProcessMin.FullPath)\" \"$([System.String]::Copy('%(__LessFilesToProcessMin.FullPath)').Replace('.less','.min.css'))\"\" />\n <Exec Command=\"\"..\\packages\\dotless.1.3.1.0\\tool\\dotless.compiler.exe\" -a \"%(__LessFilesToProcessDev.FullPath)\" \"$([System.String]::Copy('%(__LessFilesToProcessDev.FullPath)').Replace('.less','.css'))\"\" />\n</Target>Теперь генерация CSS выполняется только для тех LESS-файлов, для которых CSS-файлы существуют. По мне – очень неплохой компромис.
\nПлюсы данного подхода:
\nError List в Visual Studio;Минусы данного подхода:
\nВыводы — для меня это на данный момент рабочий вариант того, как процессить LESS в ASP.NET проектах. Приходится немного править проект руками, однако, это компенсируется дальнейшими удобствами.
\nПример проекта с таким видом процессинга на github
\nНе так давно в ASP.NET появилось пространство имен System.Web.Optimization, которое включает в себя инструменты для клиентской оптимизации. Одним из таких механизмов является возможность создания пакетов клиентских файлов (bundle).
Идея заключается в том, что в момент исполнения приложения ASP.NET создает пакет, который объединяет несколько JS или CSS файлов, при этом минифицируя их и/или выполняя еще какой-либо серверный процессинг. Собственно, идея данного способа заключается в том, что если у вас уже используются Bundle-ы для оптимизации, то вы можете встроить в эту цепочку и процессинг LESS, используя все тот же dotless, например. Как это сделать:
\nШаг 1: Подключаем dotless к проекту (описывалось ранее).
\nШаг 2: Создаем класс для LESS-трансформаций:
\nusing System.Web.Optimization;\n\npublic class LessTransform : IBundleTransform\n{\n public void Process(BundleContext context, BundleResponse response)\n {\n response.Content = dotless.Core.Less.Parse(response.Content);\n response.ContentType = \"text/css\";\n }\n}Шаг 3: Добавляем этот класс в общий список трансформаций при определении пакета:
\nvar stylesBundle = new Bundle(\"~/bundles/styles\").IncludeDirectory(\"~/Content/Styles/\", \"*.less\");\nstylesBundle.Transforms.Add(new LessTransform());\n// ...\nstylesBundle.Add(lessBundle);Теперь этот пакет можно использовать как и все остальные пакеты. Про Bundle-ы и оптимизацию можно почтитать еще тут.
\nПлюсы данного подхода:
\nМинусы данного подхода:
\nВыводы — для тех у кого итак используется Bundles для организации клиентского кода этот способ вполне может подойти. Из-за описаных выше минусов мне этот способ не очень нравится, поэтому я отдаю предпочтение процессингу LESS-файлов на этапе сборке при помощи dotless.
", "tags": [ "ASP.NET", "LESS" ], "banner_image": "https://blog.zwezdin.com/2013/less-integration-into-aspnet/fae2566c/less_integration-into-aspnet@cover.png" }, { "id": "https://blog.zwezdin.com/2013/custom-build-action/", "url": "https://blog.zwezdin.com/2013/custom-build-action/", "title": "Создание собственного типа сборки (Build Action) в Visual Studio 2013", "date_published": "2013-04-10T12:00:00.000Z", "content_html": "Visual Studio и MSBuild имеют болльше возможности для расширения. Одной из таких возможностей является возможность определения каким именно способом будет обрабатываться конкретный файл в проекте. Здесь я покажу каким образом можно создавать собственные типы сборки и для чего это может быть нужно.
\nЯ не буду пояснять синтаксис MSBuild, поэтому если вы не знакомы с ним, то перед прочтением предлагаю ознакомиться.
\nРазрабатывая приложения в Visual Studio, наверное, каждый сталкивался с параметром Build Action в окне свойств файла.
![\"Создание](\"https://blog.zwezdin.com/2013/custom-build-action/d829a39a/1@2x.png\")
\n\n\n\n\nВ зависимости от этого параметра, MSBuild корректирует своё поведение относительно того, что именно нужно сделать с конкретным файлом. Например, мы можем пометить файл как ресурс или указать, что изображение будет экраном приветствия.
\nПредставленные типы могут изменяться в зависимости от типа проекта. Например, типы сборки для консольного приложения могут отличаться от таковых для приложения ASP.NET.
\nПри разработке своих приложений может также потребоваться добавить новый тип сборки и дополнить его некоторым поведением. Это может быть полезно в случаях, когда нам нужно выполнить какой-либо пре- или пост-процессинг. Например, для web-приложений это может быть процессинг LESS/SASS или сборка JS-файлов при помощи GruntJS.
\nСуществует множество других способ сделать то же самое. Например, использовать pre- и post-build events, которые можно задать в свойствах проекта. Однако, приведенное решение по моему мнению гораздо удобнее использовать повторно и переносить на новые проекты без боли (например, через Nuget).
\nЧтобы создать новый Build Type необходимо открыть файл проекта (.csproj и др.) и добавить секцию AvailableItemName. Предположим, мы будем создавать новый тип сборки для компиляции LESS, тогда это может выглядеть так:
<ItemGroup>\n <AvailableItemName Include=\"LessBuild\" />\n</ItemGroup>Добавление этого кода в файл проекта достаточно для того, чтобы новый тип сборки появился в списке.
\n\n\n\n![\"Создание](\"https://blog.zwezdin.com/2013/custom-build-action/2cfdae52/2@2x.png\")
\n\n\n\n\nЕсли мы выберем какой-либо файл в проекте и зададим соответствующий тип сборки, то определение этого файла в проекте изменится следующим образом:
\n<ItemGroup>\n <LessBuild Include=\"StyleSheet1.less\" />\n</ItemGroup>Если мы попробуем собрать проект с новым типом сборки, то проект успешно соберется, но с ресурсом, для которого этот тип сборки задан, ничего не произойдет. Для этого нам нужно сделать ещё кое-что.
\nПри сборке ресурса нам может потребоваться запускать какую-то стороннюю утилиту или задачу MSBuild. Обработка нового типа сборки сводится к созданию и запуску нового Target в проекте MSBuild.
<Target Name=\"LessBuildTarget\" AfterTargets=\"AfterBuild\" Condition=\"'@(LessBuild)' != ''\">\n</Target>Рассмотрим подробнее как это работает.
\nTarget запускается каждый раз после сборки проекта из-за параметра AfterTargets="AfterBuild". Если вам необходимо что-то запустить перед сборкой проекта, то используйте вместо этого BeforeTargets="BeforeBuild".@(LessBuild) будет содержать их имена. Параметр Condition предотвращает запуск скрипта, если в проекте нет ни одного файла с соответствующим типом сборки.После того, как входная точка создана, остается обработать соответствующие файлы. Переменная @(LessBuild) в этом случае является строкой, в которой перечислены все файлы проекта с соответствующим типом сборки, перечисленные через точку с запятой. Получим из этой строки список файлов:
<Target Name=\"LessBuildTarget\" AfterTargets=\"AfterBuild\" Condition=\"'@(LessBuild)' != ''\">\n <ItemGroup>\n <_FilesToProcess Include=\"@(LessBuild)\"/>\n </ItemGroup>\n</Target>И теперь нам остается только обработать эти файлы, запустив какую-то внешнюю утилиту, задачу MSBuild или как-то ещё.
\n<Target Name=\"LessBuildTarget\" AfterTargets=\"AfterBuild\" Condition=\"'@(LessBuild)' != ''\">\n <ItemGroup>\n <_FilesToProcess Include=\"@(LessBuild)\"/>\n </ItemGroup>\n\n <Exec Command=\"lesscompile.exe %(_FilesToProcess.FullPath)\" />\n</Target>Разумеется, этот кусок скрипта следует переписать несколько иначе, исходя из текущих потребностей (например, обрабатывая это в несколько шагов). В данном случае я намеренно не хочу усложнять, чтобы идея осталась понятной.
\nВ итоге, мы имеем достаточно универсальный инструмент, который позволяет интегрировать сборку наших приложений с различными внешними инструментами и утилитами. Надеюсь, это сделает вашу жизнь проще.
", "tags": [ ".NET", "Visual Studio" ], "banner_image": "https://blog.zwezdin.com/2013/custom-build-action/fbad2588/custom_build-action@cover.png" }, { "id": "https://blog.zwezdin.com/2013/winrt-responsive/", "url": "https://blog.zwezdin.com/2013/winrt-responsive/", "title": "Отзывчивый дизайн в Windows RT в закрепленном режиме", "date_published": "2013-04-08T12:00:00.000Z", "content_html": "В современном мире большое количество различных форм-факторов устройств. Игнорировать этот факт с каждым днем становится все сложнее. Поэтому для адаптации содержимого веб-страниц используют “резиновую” сетку на странице в совокупности с медиа-запросами. Это принятно называть отзывчивым веб-дизайном. Большое количество сайтов с отзывчивым дизайном представлено на сайте http://mediaqueri.es/.
\nК сожалению, не все так гладко в высокотехнологичном мире. Так, например, если мы откроем сайт с медиа-запросами в Windows RT (Internet Explorer Metro mode) и прикрепим окно к краю экрана (snapped mode), то медиа-запросы не сработают, а сайт будет представлен в уменьшенном виде. Логично было бы предположить, что медиа-запросы должны срабатывать и в этом случае, а сайт изменять свой вид. Давайте посмотрим, как можно исправить это недоразумение.
\nОсновная идея отзывчивых веб-сайтов – использование резиновой сетки (когда содержимое растягивается по ширине окна, а ширина элементов задается в процентах) и использовании медиа-запросов. Медиа-запросы позволяют включать и отключать различные стили, в зависимости от ширины контейнера.
\nДля определения медиа-запроса в CSS-документе используется следующий селектор:
\n@media only screen and (max-width : 600px)\n{\n}После применения такого селектора, сайт может выглядеть по-разному в различных форматах:
\n\n\n\n![\"Отзывчивый](\"https://blog.zwezdin.com/2013/winrt-responsive/f07b7658/1@2x.png\")
\n\n\n\n\n\n\n\n ![\"Отзывчивый](\"https://blog.zwezdin.com/2013/winrt-responsive/90a02bbc/2@2x.png\")
\n\n\n\n\nЧтобы заставить медиа-запросы работать на мобильных устройствах с большим разрешением, задаются параметры viewport, которые говорят о том, что размер страницы устанавливается на основе ширины устройства:
\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0, maximum-scale=1.0\">Теперь наша страница готова для того, чтобы адаптироваться к различным размерам экранов.
\nКак уже упоминалось выше, если мы прикрепим браузер Windows RT к краю экрана, то несмотря на небольшую ширину окна браузера, медиа-запросы работать не будут. В итоге мы увидим сайт, на котором достаточно трудно разглядеть даже заголовки:
\n\n\n\n![\"Отзывчивый](\"https://blog.zwezdin.com/2013/winrt-responsive/7cd613a2/3@2x.png\")
\n\n\n\n\nКак видно, браузер просто игнорирует медиа-запросы и отображает документ так, как будто его просматривают на полный экран. Нехорошо.
\nЧтобы исправить это поведение, в CSS нужно добавить специальное правило, которое указывает на то, что в таких случаях страницу нужно отображать с меньшей шириной:
\n@media only screen and (max-width : 320px)\n{\n @-ms-viewport\n {\n width: 320px;\n }\n}Добавим это правило в CSS-документ и обновим страницу. Результат:
\n\n\n\n![\"Отзывчивый](\"https://blog.zwezdin.com/2013/winrt-responsive/557d07e5/4@2x.png\")
\n\n\n\n\nКостыль? Да. Но оставлять без внимания пользователей Windows 8 тоже нельзя. Поэтому адаптируйте ваши сайты и под Internet Explorer в snapped-режиме.
", "tags": [ "Фронтенд", "CSS" ], "banner_image": "https://blog.zwezdin.com/2013/winrt-responsive/e9ecf663/winrt_responsive@cover.png" }, { "id": "https://blog.zwezdin.com/2013/code-generating-with-roslyn/", "url": "https://blog.zwezdin.com/2013/code-generating-with-roslyn/", "title": "Генерация кода на языке C# с использованием Roslyn", "date_published": "2013-04-02T12:00:00.000Z", "content_html": "Roslyn можно использовать не только для анализа кода, но и для генерации. В контексте генерации кода обычно рассматриваются два варианта – изменение структуры существующего кода и генерация кода с нуля. Рассмотрим оба варианта.
\nЭлементы дерева кода Roslyn Compiler API состоят из объектов, которые являются наследниками абстрактного класса SyntaxNode. Для генерации элементов синтаксического дерева используется вспомогательный класс Syntax.
Рассмотрим процесс генерации кода на примере генерации простого метода. Метод описывается классом MethodDeclarationSyntax. Чтобы создать этот класс воспользуемся методом Syntax.MethodDeclaration(), указав тип возвращаемого значения и имя генерируемого метода:
MethodDeclarationSyntax method =\n Syntax.MethodDeclaration(Syntax.ParseTypeName(\"string\"), \"TestMethod\")Добавим к нашему методу модификаторы, которые говорят о том, что метод статический и публичный:
\nMethodDeclarationSyntax method =\n Syntax.MethodDeclaration(Syntax.ParseTypeName(\"string\"), \"TestMethod\")\n .AddModifiers(Syntax.Token(SyntaxKind.PublicKeyword))\n .AddModifiers(Syntax.Token(SyntaxKind.StaticKeyword))Теперь самое время определить тело метода. Для этого существует метод AddBodyStatements(), который принимает переменное число параметров (в зависимости от того, какое количество statement-ов мы хотим добавить). Также можно вызвать этот метод несколько раз, что на мой взгляд удобнее.
Пусть тело метода содержит вызов метода Console.Write(), параметром которого является строка test. Для этого нам нужно создать цепочку ExpressionStatementSyntax (выражение, которое будет добавлено в тело метода) – InvocationExpressionSyntax (вызов метода) – MemberAccessExpressionSyntax (обращение к методу). Кроме того, для вызова метода нужно передать параметры. Вот как будет выглядеть код по заполнению тела метода:
.AddBodyStatements(\n Syntax.ExpressionStatement(\n Syntax.InvocationExpression(\n Syntax.MemberAccessExpression(SyntaxKind.MemberAccessExpression, Syntax.IdentifierName(\"Console\"),\n Syntax.IdentifierName(\"Write\")),\n Syntax.ArgumentList(\n Syntax.SeparatedList(\n Syntax.Argument(Syntax.LiteralExpression(SyntaxKind.StringLiteralExpression, Syntax.Literal(\"test\")))\n ))\n )\n )\n)Добавим также к телу метода вызов оператора return, который будет возвращать строку OK:
.AddBodyStatements(\n Syntax.ReturnStatement(\n Syntax.LiteralExpression(SyntaxKind.StringLiteralExpression, Syntax.Literal(\"OK\"))\n )В итоге код для генерации нашего тестового метода будет выглядеть так:
\nMethodDeclarationSyntax method =\n Syntax.MethodDeclaration(Syntax.ParseTypeName(\"string\"), \"TestMethod\")\n .AddModifiers(Syntax.Token(SyntaxKind.PublicKeyword))\n .AddModifiers(Syntax.Token(SyntaxKind.StaticKeyword))\n .AddBodyStatements(\n Syntax.ExpressionStatement(\n Syntax.InvocationExpression(\n Syntax.MemberAccessExpression(SyntaxKind.MemberAccessExpression, Syntax.IdentifierName(\"Console\"),\n Syntax.IdentifierName(\"Write\")),\n Syntax.ArgumentList(\n Syntax.SeparatedList(\n Syntax.Argument(Syntax.LiteralExpression(SyntaxKind.StringLiteralExpression, Syntax.Literal(\"test\")))\n ))\n )\n )\n )\n .AddBodyStatements(\n Syntax.ReturnStatement(\n Syntax.LiteralExpression(SyntaxKind.StringLiteralExpression, Syntax.Literal(\"OK\"))\n )\n );Выглядит немного громоздко, но это издержки данной предметной области и к этому быстро привыкаешь.
\nДалее нам необходимо создать объект CompilationUnitSyntax. В дальнейшем он потребовался бы нам, если бы мы захотели скомпилировать данный код. В нашем случае он будет необходим нам для того, чтобы отформатировать исходный текст (расставить отсутпы и переносы строк):
CompilationUnitSyntax tree = Syntax.CompilationUnit()\n .AddMembers(method);\n\nConsole.WriteLine(tree\n .Format(FormattingOptions.GetDefaultOptions()).GetFormattedRoot()\n .ToFullString());Метод Format() в данном случае как раз выполняет форматирование кода, а метод ToFullString() отдает нам строковое представление сгенерированного кода.
![\"Генерация](\"https://blog.zwezdin.com/2013/code-generating-with-roslyn/f845b9a3/1@2x.png\")
\n\n\n\n\nАналогичным образом генерируются классы, пространства имен и т.д. Таким образом, мы можем получить полноценный сгенерированный код, который в дальнейшем будем компилировать.
\nДругой сценарий – взять уже существующий код и модифицировать в соответствии с некоторыми правилами. За основу возьмем файл из библиотеки Monads.NET. При помощи синтаксического дерева Roslyn Compiler API найдем первый метод в исходном файле и будем его модифицировать:
\npublic static TSource Do<TSource>(this TSource source, Action<TSource> action)\n where TSource : class\n{\n if (source != default(TSource))\n {\n action(source);\n }\n\n return source;\n}В этом методе есть условный оператор if, давайте попробуем изменить его условие:
SyntaxTree tree = SyntaxTree.ParseText(source);\nMethodDeclarationSyntax method = tree.GetRoot()\n .DescendantNodes()\n .OfType<MethodDeclarationSyntax>()\n .First();\n\nIfStatementSyntax ifStatement = method\n .DescendantNodes()\n .OfType<IfStatementSyntax>()\n .First();\n\nmethod = method.ReplaceNode(ifStatement,\n ifStatement\n .WithCondition((Syntax.LiteralExpression(SyntaxKind.TrueLiteralExpression)))\n );Ключевой момент – вызов метода ReplaceNode. Первый аргумент этого метода – узел, который мы хотим заменить, второй – новое состояние этого узла. Вызов метода WithCondition позволяет заменить условие оператора if.
![\"Генерация](\"https://blog.zwezdin.com/2013/code-generating-with-roslyn/a45aeff1/2@2x.png\")
\n\n\n\n\nЕсли требуется какая-то более общая замена, вместо изменения условия, то для узла следует использовать метод Update. Давайте найдем элемент BlockSyntax (тело метода), и заменить его на пустую коллекцию:
SyntaxTree tree = SyntaxTree.ParseText(source);\nMethodDeclarationSyntax method = tree.GetRoot()\n .DescendantNodes()\n .OfType<MethodDeclarationSyntax>()\n .First();\n\nBlockSyntax methodBody = method\n .DescendantNodes()\n .OfType<BlockSyntax>()\n .First();\n\nmethod = method.ReplaceNode(methodBody,\n methodBody.Update(methodBody.OpenBraceToken, new SyntaxList<StatementSyntax>(), methodBody.CloseBraceToken));Как видно, в метод Update вторым параметром передается коллекция элементов. Эта коллеция и содержит новое тело метода. Поскольку в данном случае она пустая, то и тело обновленное тело метода будет пустым.
![\"Генерация](\"https://blog.zwezdin.com/2013/code-generating-with-roslyn/bbb0e39f/3@2x.png\")
\n\n\n\n\nНаконец, третий вариант изменения структуры кода – использование паттерна Visitor. Для этого нужно реализовать объект-visitor, унаследовав его от базового класса SyntaxRewriter. В созданном классе можно переопределить нужный метод, в зависимости от того, с каким типом элементов требуется работать. В нашем случае мы будем искать элемент типа BlockSyntax, поэтому переопределим метод VisitBlock:
public class MyRewriter : SyntaxRewriter\n{\n public override SyntaxNode VisitBlock(BlockSyntax node)\n {\n if (node.DescendantNodes().OfType<BlockSyntax>().Count() >= 1)\n return node.Update(node.OpenBraceToken,\n new SyntaxList<StatementSyntax>(),\n node.CloseBraceToken);\n\n return base.VisitBlock(node);\n }\n}Для того, чтобы запустить этот Visitor используем следующий простой код:
\nSyntaxNode updatedTree = new MyRewriter()\n .Visit(SyntaxTree.ParseText(source)\n .GetRoot());Вызов метода Visit() запустит Visitor и вернет обновленное дерево, которое как и в предыдущем случае будет содержать очищенное тело метода:
![\"Генерация](\"https://blog.zwezdin.com/2013/code-generating-with-roslyn/26177a3d/4@2x.png\")
\n\n\n\n\nТаким образом, Roslyn Compiler API предоставляет множество различных способов по генерации и модфикации кода. Несмотря на некоторую громозкость кода, API достаточно простой и логичный.
", "tags": [ "C#", ".NET", "Roslyn" ], "banner_image": "https://blog.zwezdin.com/2013/code-generating-with-roslyn/61dd70e0/code_generating-with-roslyn@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/csharp-code-analysis-with-roslyn/", "url": "https://blog.zwezdin.com/2013/csharp-code-analysis-with-roslyn/", "title": "Анализ кода на языке C# с использованием Roslyn", "date_published": "2013-03-22T12:00:00.000Z", "content_html": "Одной из самых важных частей Roslyn является возможность анализа кода – Roslyn Compiler API. Для экспериментов с Roslyn Compiler API возьмем файл из библиотеки Monads.NET. Я разместил этот файл в ресурсах приложения, чтобы иметь быстрый доступ к нему из любого места в коде.
\nComplier API начинается с класса SyntaxTree – это класс являющийся точкой входа для работы с Roslyn Compiler API. Чтобы выполнить разбор исходного кода, необходимо вызвать статический метод ParseText (если исходный код содержится в строковой переменной) или ParseFile (если исходный код находится в файле, путь до конторого известен) у базового объекта SyntaxTree.
При анализе кода в Roslyn Compiler API очень удобно получить список всех дочерних элементов, а затем по типу выбрать то, что нас интересует. Каждый тип блока кода имеет собственный класс-наследник базового класса SyntaxNode. Например, элемент, описывающий метод класса представлен классом MethodDeclarationSyntax, элемент, описывающий цикл while – классом WhileStatementSyntax и т.д. Таким образом, чтобы получить список всех методов, которые находятся в исследуемом исходном файле можно использовать следующий код:
SyntaxTree tree = SyntaxTree.ParseText(source);\nIEnumerable<MethodDeclarationSyntax> methods = tree\n .GetRoot()\n .DescendantNodes()\n .OfType<MethodDeclarationSyntax>();При обращении к методу DescendantNodes() можно использовать лямбда-выражение, которое также отфильтрует набор исходных элементов.
После получения списка методов можно пройтись по нему и отобразить имя каждого метода:
\nforeach (MethodDeclarationSyntax method in methods)\n{\n SyntaxToken methodName = method.Identifier;\n Console.WriteLine(\"{0}()\", methodName);\n}![\"Анализ](\"https://blog.zwezdin.com/2013/csharp-code-analysis-with-roslyn/dc85e3a8/1@2x.png\")
\n\n\n\n\nПоскольку MethodDeclarationSyntax и другие синтаксические единицы наследники одного и того же базового класса, дальнейшие действия по анализу кода сводятся к похожим конструкциям. Давайте подсчитаем количество блоков разного типа в каждом из методов. Для этого сначала получим тело метода – это элемент типа BlockSyntax, внутри которого будем искать элементы нужного нам типа.
SyntaxTree tree = SyntaxTree.ParseText(source);\nIEnumerable<MethodDeclarationSyntax> methods = tree\n .GetRoot()\n .DescendantNodes()\n .OfType<MethodDeclarationSyntax>();\n\nforeach (MethodDeclarationSyntax method in methods)\n{\n SyntaxToken methodName = method.Identifier;\n BlockSyntax methodBody = method.ChildNodes().OfType<BlockSyntax>().Single();\n\n int ifStatementCount = methodBody.DescendantNodes().OfType<IfStatementSyntax>().Count();\n int returnStatementCount = methodBody.DescendantNodes().OfType<ReturnStatementSyntax>().Count();\n int throwStatementCount = methodBody.DescendantNodes().OfType<ThrowStatementSyntax>().Count();\n int tryStatementCount = methodBody.DescendantNodes().OfType<TryStatementSyntax>().Count();\n\n Console.WriteLine(\"{0}()\", methodName);\n Console.WriteLine(\"if: {0}\\treturn: {1}\\tthrow: {2}\\ttry: {3}\",\n ifStatementCount, returnStatementCount, throwStatementCount, tryStatementCount);\n Console.WriteLine();\n}Здесь для каждого метода подсчитывается число дочерних элементов каждого из типов.
\n\n\n\n![\"Анализ](\"https://blog.zwezdin.com/2013/csharp-code-analysis-with-roslyn/8379dd32/2@2x.png\")
\n\n\n\n\nДалее запросы к коду строятся аналогично. Когда это может быть полезно? Вариантов применения множество – подсчет метрик кода, любой анализ кода, автоматизированный рефакторинг кода и т.д.
", "tags": [ "C#", ".NET", "Roslyn" ], "banner_image": "https://blog.zwezdin.com/2013/csharp-code-analysis-with-roslyn/b7f54a06/csharp_code-analysis-with-roslyn@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/roslyn-as-a-scripting-language/", "url": "https://blog.zwezdin.com/2013/roslyn-as-a-scripting-language/", "title": "Использование Roslyn в качестве скриптового языка в своем приложении", "date_published": "2013-03-13T12:00:00.000Z", "content_html": "Платформа Roslyn позволяет разработчикам встраивать компиляцию и исполнения кода прямо в приложение. Эта часть платформы Roslyn называется Scripting API. С её помощью вы можете исполнить код, который вводит пользователь или который, например, хранится в базе данных.
\nНа первый взгляд может показаться, что эта функциональность не имеет большого применения в практических задачах. На самом деле это может быть удобно в различного рода конструкторах форм, CMS, настраиваемых системах документооборота и там, где мы хотим доверить настройку приложения пользователю чуть больше, чем обычно.
\nДля того, чтобы работать с компонентами Roslyn следует добавить ссылку на сборки Roslyn.
\n\n\n\n![\"Использование](\"https://blog.zwezdin.com/2013/roslyn-as-a-scripting-language/b0c847e4/1@2x.png\")
\n\n\n\n\nДля использования скриптового механизма Roslyn нам понадобится объект ScriptingEngine. Этот объект отвечает за исполнение кода и имеет API для управления зависимостями на внешние модули:
ImportNamespace – позволяет импортировать пространство имен для использования его в коде (аналог using);AddReference – позволяет задать ссылку на внешюю сборку;SetReferenceSearchPaths – позволяет указать одну или несколько папок, в которых будет производится поиск сборок для разрешения зависимостей на внешние сборки.Кроме задания зависимостей, можно определить какие зависимости уже установлены. Для этого существуют методы GetReferences() и GetImportedNamespaces().
После создания ScriptingEngine и указания всех зависимостей нужно создать сессию, в рамках которой мы будем исполнять код. Сессия позволяет объединить последовательность нескольких вызовов и разделять между собой какие-то данные. В некотором приближении сессию можно рассматривать как запуск приложения. Для создания новой сессии используется метод CreateSession.
После того, как сессия создана, можно запускать собственный код. Для этого у объекта Session (результат выполнения CreateSession) существует метод Execute. Я создал консольное приложение, в котором считываю пользовательский ввод и запускаю его:
ScriptEngine host = new ScriptEngine();\nhost.ImportNamespace(\"System\");\n\nSession session = host.CreateSession();\n\nConsole.WriteLine(\"Define your command:\");\nstring input;\nwhile ((input = Console.ReadLine()) != String.Empty)\n{\n try\n {\n session.Execute(input);\n }\n catch (CompilationErrorException ex)\n {\n Console.WriteLine(ex.Message);\n }\n}Результат работы приложения:
\n\n\n\n![\"Использование](\"https://blog.zwezdin.com/2013/roslyn-as-a-scripting-language/229441ee/2@2x.png\")
\n\n\n\n\nМетод Execute возвращает результат в виде общего типа object. Это полезно тогда, когда исполняемое выражение возвращает какой-то результат, который можно использовать далее:
try\n{\n var result = session.Execute(input);\n Console.WriteLine(result);\n}\ncatch (CompilationErrorException ex)\n{\n Console.WriteLine(ex.Message);\n}В результате:
\n\n\n\n![\"Использование](\"https://blog.zwezdin.com/2013/roslyn-as-a-scripting-language/a753a61f/3@2x.png\")
\n\n\n\n\nЕсли предполагается в качестве результата получить какой-то конкретный тип, то использовать object не очень удобно. В этом случае можно использовать перегруженный метод Execute<T>():
try\n{\n int result = session.Execute<int>(input);\n Console.WriteLine(result);\n}\ncatch (CompilationErrorException ex)\n{\n Console.WriteLine(ex.Message);\n}В целом, Roslyn Scripting API мне представляется очень преспективной разработкой. С его помощью можно настраивать отдельные части приложения с одной стороны гибко, а с другой — без необходимости перекомпиляции всего приложения. Если вдуматься, то в некотором смысле Roslyn Scripting API является конкуретном Workflow Foundation, которая так и не заняла место в сердцах разработчиков.
", "tags": [ "C#", ".NET", "Roslyn" ], "banner_image": "https://blog.zwezdin.com/2013/roslyn-as-a-scripting-language/86d22c92/roslyn_as-a-scripting-language@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/windows-phone-calendar/", "url": "https://blog.zwezdin.com/2013/windows-phone-calendar/", "title": "Получение содержимого календаря в приложении Windows Phone 8", "date_published": "2013-02-07T12:00:00.000Z", "content_html": "Windows Phone 8 SDK позволяет сторонним программам получить доступ к содержимому календаря на устройстве. Это может быть полезным при создании приложений-планировщиков или приложений, чья логика зависит от содержимого календаря.
\nДля получения доступа к календарю необходимо установить соответствующее разрешение – ID_CAP_APPOINTMENTS.
![\"Получение](\"https://blog.zwezdin.com/2013/windows-phone-calendar/da6fe845/1@2x.png\")
\n\n\n\n\nДля получения доступа к содержимому календаря используется объект Appointments. Аналогично тому, как выбираются данные из списка контактов, для получения содержимого календаря нужно сформировать поисковый запрос. Поисковой запрос содержит промежуток времени за который нужно выбрать записи. Кроме того, можно указать максимальное число записей, которые могут быть получены и учетную запись, в которой эти записи хранятся. Для выполнения поискового запроса необходимо выполнить метод SearchAsync. Когда будет получен результат, операционная система сгенерирует событие SearchCompleted. Таким образом, код по получению данных из календаря за последние две недели будет выглядеть так:
protected override void OnNavigatedTo(NavigationEventArgs e)\n{\n Appointments calendar = new Appointments();\n calendar.SearchCompleted += calendar_SearchCompleted;\n calendar.SearchAsync(DateTime.Now.AddDays(-14), DateTime.Now, null);\n\n base.OnNavigatedTo(e);\n}\n\nvoid calendar_SearchCompleted(object sender, AppointmentsSearchEventArgs e)\n{\n AppointmentsList.ItemsSource = e.Results;\n}Добавим на страницу ListBox и определим для каждой записи календаря шаблон:
\n<ListBox x:Name=\"AppointmentsList\">\n <ListBox.ItemTemplate>\n <DataTemplate>\n <StackPanel Margin=\"0\">\n <TextBlock Text=\"{Binding Subject}\" Style=\"{StaticResource PhoneTextNormalStyle}\" FontWeight=\"Bold\" />\n <TextBlock Text=\"{Binding Details}\" Style=\"{StaticResource PhoneTextNormalStyle}\" />\n </StackPanel>\n </DataTemplate>\n </ListBox.ItemTemplate>\n</ListBox>Этот код выберет из календаря все записи за последние две недели и отобразит их на странице.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2013/windows-phone-calendar/06587085/windows_phone-calendar@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/windows-phone-contacts/", "url": "https://blog.zwezdin.com/2013/windows-phone-contacts/", "title": "Получение списка контактов из приложения Windows Phone 8", "date_published": "2013-02-04T12:00:00.000Z", "content_html": "Windows Phone 8 имеет встроенное приложение для хранения контактов. Контакты используются при совершении исходящих и получении входящих звонков, создании SMS или e-mail сообщения и в любом другом месте, где требуется контактная информация людей из записной книжки. Очевидно, что приложению тоже может потребоваться эта информация, поэтому давайте рассмотрим код, в котором мы получим доступ к списку контактов.
\nПервое, что необходимо сделать — разрешить приложению получать доступ к списку контактов. Для этого необходимо установить разрешение ID_CAP_CONTACTS в манифесте приложения:
![\"Получение](\"https://blog.zwezdin.com/2013/windows-phone-contacts/ed42b331/1@2x.png\")
\n\n\n\n\nДля получения доступа к списку контактов используется объект Contacts из пространства имен Microsoft.Phone.UserData. Для получения списка контактов следует создать новый объект Contacts и выполнить поисковый запрос путем вызова метода SearchAsync. Для получения всех контактов нужно передать пустую строку. Второй параметр этого метода указывает какие именно данные нужно учитывать при выполнении поиска (например, можно искать по номеру телефона или e-mail). Третий параметр – объект состояния, который будет доступен при получении результата. При завершении операции поиска контактов будет сгенерировано событие SearchCompleted, в параметрах которого можно найти результат. Выведем все контакты из списка контактов в ListBox на форме при открытии страницы:
protected override void OnNavigatedTo(NavigationEventArgs e)\n{\n Contacts contacts = new Contacts();\n\n contacts.SearchCompleted += OnContactsSearchCompleted;\n contacts.SearchAsync(String.Empty, FilterKind.None, null);\n\n base.OnNavigatedTo(e);\n}\n\nprivate void OnContactsSearchCompleted(object sender, ContactsSearchEventArgs e)\n{\n ContactsList.ItemsSource = e.Results;\n}Коллекция Results содержит список всех найденых контактов. Каждый объект этой коллекции содержит исчерпывающую информацию о контакте.
Нередко требуется получить также и фото контакта. Для этого у каждого объекта Contact из коллекции Results существует метод GetPicture, который возвращает поток с изображением. Изменим немного обработчик события получения контактов:
private void OnContactsSearchCompleted(object sender, ContactsSearchEventArgs e)\n{\n ContactsList.ItemsSource = e.Results.Select(x =>\n {\n BitmapImage photo = null;\n try\n {\n Stream imageSource = x.GetPicture();\n\n if (imageSource != null)\n {\n photo = new BitmapImage();\n photo.SetSource(imageSource);\n }\n }\n catch (Exception ex)\n {\n Debug.WriteLine(ex);\n }\n\n return new\n {\n Name = x.DisplayName,\n Image = photo\n };\n});\n}Здесь мы для каждого контакта проверяем наличие изображения и, если оно существует, получаем его. Для отображения в пользовательском интерфейсе подготовим объект BitmapImage. Теперь для отображения создадим DataTemplate для элемента ListBox, который отображает наши контакты:
<ListBox x:Name=\"ContactsList\">\n <ListBox.ItemTemplate>\n <DataTemplate>\n <Grid>\n <Grid.ColumnDefinitions>\n <ColumnDefinition Width=\"100\" />\n <ColumnDefinition Width=\"*\" />\n </Grid.ColumnDefinitions>\n\n <Image Grid.Column=\"0\"\n Margin=\"10\"\n Width=\"100\" Height=\"100\"\n Source=\"{Binding Image}\"/>\n\n <TextBlock Grid.Column=\"1\"\n Margin=\"10\"\n Text=\"{Binding Name}\"\n VerticalAlignment=\"Center\"\n Style=\"{StaticResource PhoneTextNormalStyle}\"/>\n </Grid>\n </DataTemplate>\n </ListBox.ItemTemplate>\n</ListBox>Теперь приложение отображает список контактов с фотографиями.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2013/windows-phone-contacts/99595b58/windows_phone-contacts@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/windows-phone-camera-access/", "url": "https://blog.zwezdin.com/2013/windows-phone-camera-access/", "title": "Доступ к камере в Windows Phone 8", "date_published": "2013-01-26T12:00:00.000Z", "content_html": "В любом устройстве на Windows Phone есть камера. Еще с первых версий WP7 SDK был возможен программный доступ к камере и осущствлялся при помощи стандартных диалогов. Это позволяло запустить стандартное приложение для получения фотографий, получить изображение и передать его в приложение. Все это отлично работало в сценариях получения одной статической фотографии и дальнейшей её обработки. Однако, при таком подходе становятся невозможными многие сценарии, например возможность создания приложения дополненной реальности. Поэтому Windows Phone 8 SDK содержит механизмы прямого доступа к камере, минуя стандартный диалог операционной системы.
\nЧтобы воспользоваться возможностями доступа к камере в манифесте приложения необходимо установить возможность ID_CAP_ISV_CAMERA.
![\"Доступ](\"https://blog.zwezdin.com/2013/windows-phone-camera-access/6f0318ad/1@2x.png\")
\n\n\n\n\nЗа доступ к камере отвечает объект PhotoCamera. Прежде чем проинициализировать камеру, следует проверить её доступность. Для этого следует вызвать статический метод IsCameraSupported() В Windows Phone 8 можно работать с задней и основной камерой. При использовании камеры следует указать какую именно из них мы хотим использовать.
if (PhotoCamera.IsCameraTypeSupported(CameraType.Primary) == true)\n{\n // ...\n}Чтобы отобразить картинку с камеры, необходимо добавить на страницу элемент VideoBrush. Для этого создадим визуальный объект, например Rectangle, и в качестве заливки установим VideoBrush:
<Rectangle Height=\"400\" Width=\"400\">\n <Rectangle.Fill>\n <VideoBrush x:Name=\"video\"></VideoBrush>\n </Rectangle.Fill>\n</Rectangle>Для простого доступа к VideoBrush я задал имя. Понятно, что этого можно не делать и найти VideoBrush через свойство Fill основного элемента.
Теперь можно проинициализировать камеру. Для этого создадим объект PhotoCamera и укажем куда именно нужно отображать видеопоток:
if (PhotoCamera.IsCameraTypeSupported(CameraType.Primary) == true)\n{\n _camera = new PhotoCamera(CameraType.Primary);\n video.SetSource(_camera);\n}Теперь, если мы запустим наше приложение, то на странице появится видео, которое передается с камеры. Операционная система передает перевернутое изображение. Чтобы корректно отображать картинку, повернем изображение на 90 градусов. Для этого воспользуемся стандартными трансформациями элементов управления в XAML:
<Rectangle Height=\"400\" Width=\"400\">\n <Rectangle.RenderTransform>\n <RotateTransform Angle=\"90\" CenterX=\"200\" CenterY=\"200\"></RotateTransform>\n </Rectangle.RenderTransform>\n <Rectangle.Fill>\n <VideoBrush x:Name=\"video\"></VideoBrush>\n </Rectangle.Fill>\n</Rectangle>Запустим приложение и увидим изображение с камеры:
\n\n\n\n![\"Доступ](\"https://blog.zwezdin.com/2013/windows-phone-camera-access/8a074db9/2@2x.jpg\")
\n\n\n\n\nДля корректной работы приложения следует также позаботиться о том, чтобы удалять объект PhotoCamera, когда он становится ненужным. Поэтому я добавлю на страницу следующий код:
protected override void OnNavigatedFrom(NavigationEventArgs e)\n{\n if (_camera != null)\n _camera.Dispose();\n\n base.OnNavigatedFrom(e);\n}Он уничтожает объект PhotoCamera как только мы уходим со страницы.
Скорее всего вам захочется не только отображать изображение на странице, но и захватывать его для дальнейшей обработки или сохранения. Для того, чтобы получить изображение с камеры необходимо вызвать метод CaptureImage:
private void CaptureClick(object sender, RoutedEventArgs e)\n{\n _camera.CaptureImage();\n}Этот вызов сообщит камере о том, что приложение хочет получить полноразмерную картинку. Когда камера будет готова отдать изображение будет сгенерировано событие CaptureImageAvailable. Поэтому все, что нам необходимо сделать – подписаться на событие и обработать данные с камеры в обработчике:
protected override void OnNavigatedTo(NavigationEventArgs e)\n{\n if (PhotoCamera.IsCameraTypeSupported(CameraType.Primary) == true)\n {\n _camera = new PhotoCamera(CameraType.Primary);\n _camera.CaptureImageAvailable += _cam_CaptureImageAvailable;\n video.SetSource(_camera);\n }\n\n base.OnNavigatedTo(e);\n}\n\nvoid _cam_CaptureImageAvailable(object sender, ContentReadyEventArgs e)\n{\n // e.ImageStream\n}Рассмотрев возможности смены фонового изображения экрана блокировки Windows Phone 8, перейдем к рассмотрению возможностей отображения сообщений и статуса на экране блокировки. В качестве примера отображения статуса можно привести отображение предстоящих событий из календаря. Кроме того, на экране блокировки можно увидеть количество пропущенных звонков или непрочтенных сообщений электронной почты – аналогичные счетчики можно отображать из своего приложения.
\nТехнически, статус приложения на главном экране — это та же самая информация, которая отображается на плитке приложения (Live Tile). Поэтому все, что необходимо сделать, указать приложению, что эту информацию нужно отображать также на экране блокировки. Для этого в файле манифеста приложение следует добавить соответствующие элементы Extension:
<Extensions>\n <Extension ExtensionName=\"LockScreen_Notification_IconCount\"\n ConsumerID=\"{111DFF24-AA15-4A96-8006-2BFF8122084F}\"\n TaskID=\"_default\" />\n <Extension ExtensionName=\"LockScreen_Notification_TextField\"\n ConsumerID=\"{111DFF24-AA15-4A96-8006-2BFF8122084F}\"\n TaskID=\"_default\" />\n</Extensions>Теперь, приложение появится в списке уведомления на системном экране настроек экрана блокировки.
![\"Управление](\"https://blog.zwezdin.com/2013/windows-phone-lock-screen-part2/7f591a83/1@2x.jpg\")
\n\n\n\n\nЧтобы задать иконку для счетчика приложения, в манифесте приложения следует задать элемент DeviceLockImageURI для плитки приложения (например, TemplateFlip, которая создается по умолчанию при создании проекта):
<DeviceLockImageURI IsRelative=\"true\" IsResource=\"false\">Assets\\LockScreenIcon.png</DeviceLockImageURI>Чтобы обновить текст на экране блокировки достаточно изменить информацию на плитке:
\nShellTile.ActiveTiles.First().Update(new FlipTileData { Count = 22, WideBackContent = \"Hello!\" });Одно из нововведений в Windows Phone 8 SDK — возможность интеграции приложений с экраном блокировки устройства. В этой части будет рассмотрена возможность смены фонового изображения. Эта возможность будет полезна для приложений, работающих с изображениями (например, клиенты социальных сетей, приложения для обработки фото и т.д.).
\nДля того, чтобы приложение стало провайдером фонового изображения экрана блокировки, необходимо это явно указать в манифесте приложения. Без этого все дальнейшие шаги будут невозможны. Кроме того, после задания этого разрешения, приложение появится в списке в системном окне настройки экрана блокировки.
\n\n\n\n![\"Управление](\"https://blog.zwezdin.com/2013/windows-phone-lock-screen-part1/6b38907b/1@2x.jpg\")
\n\n\n\n\nЧтобы задать это разрешение, необходимо открыть файл манифеста приложения в XML-редакторе и добавить туда Extension:
<Tokens>\n <!-- ... -->\n</Tokens>\n<Extensions>\n <Extension ExtensionName=\"LockScreen_Background\" ConsumerID=\"{111DFF24-AA15-4A96-8006-2BFF8122084F}\" TaskID=\"_default\" />\n</Extensions>\n<ScreenResolutions>\n <!-- ... -->\n</ScreenResolutions>После того, как манифест был изменен, необходимо сделать сделать три действия: 1) задать фоновое изображение, которое будет использоваться по умолчанию; 2) добавить обработку ситуации перехода к приложению из экрана системных настроек; 3) если это необходимо, изменять фоновое изображение экрана блокировки.
\nКогда мы указали, что приложение может быть использовано в качестве провайдера фонового изображения (путем добавления элемента Extension в файл манифеста), оно появится в списке приложений на экране настроек. Пользователь может выбрать это приложение в качестве источника фонового изображение, но само приложение не запустить. В этом случае у приложения нет возможности запустить какой-либо код и инциализировать фоновое изображение. Для таких случаев в приложении можно добавить изображение, которое будет использовано по умолчанию.
Чтобы добавить стандартное фоновое изображение, необходимо в приложение добавить файл с именем DefaultLockScreen.jpg (имя файла должно быть именно таким) и установить для него Build Action в режим Content. Это позволит включить данный файл в пакет приложения. Теперь это изображение будет использоваться в качестве стандартного фонового изображения, когда в приложение будет использовано в качестве провайдера фонового изображения.
Приложение можно запустить из экрана системных настроек. Для этого нужно нажать кнопку открыть приложение, когда приложение выбрано в списке.
![\"Управление](\"https://blog.zwezdin.com/2013/windows-phone-lock-screen-part1/6b38907b/2@2x.jpg\")
\n\n\n\n\nОчевидно, что такую ситуацию нужно обрабатывать, чтобы сразу переходить к настройке фонового изображения. Чтобы добавить такую обработку, на главной странице следует переопределить метод OnNavigatedTo. Если мы перешли к странице сразу после запуска приложения (e.NavigationMode == NavigationMode.New) и существует параметр в QueryString с именем WallpaperSettings и равный 1, то это как раз случай перехода к приложению из настроек. Код для перехода к странице настроек внутри приложения будет выглядеть следующим образом:
protected override void OnNavigatedTo(NavigationEventArgs e)\n{\n if (IsNavigatedFromWallpaperSettings(e, NavigationContext.QueryString) == true)\n NavigationService.Navigate(new Uri(\"/LockScreenSettings.xaml\", UriKind.Relative));\n\n base.OnNavigatedTo(e);\n}\n\nprivate bool IsNavigatedFromWallpaperSettings(NavigationEventArgs e, IDictionary<string, string> queryString)\n{\n if (e.NavigationMode == NavigationMode.New)\n {\n string wallpaperSettings;\n return (queryString.TryGetValue(\"WallpaperSettings\", out wallpaperSettings) == true) && (wallpaperSettings == \"1\");\n }\n else\n return false;\n}Теперь при переходе к приложению из экрана настроек будет открываться страница LockScreenSettings.xaml.
Прежде чем приложением сможет изменять фон экрана блокировки, следует убедиться используется ли это приложение в качестве источника фонового изображения. Для этого используется объект LockScreenManager. Кроме того, с помощью этого объекта можно запросить у пользователя использовать данное приложение для экрана блокировки. Разместим на главной странице кнопку, которая будет запрашивать данное разрешение. Кнопка будет скрываться, если приложение уже итак используется для экрана блокировки:
protected override void OnNavigatedTo(NavigationEventArgs e)\n{\n // ..\n\n UseAppAsBackground.Visibility = LockScreenManager.IsProvidedByCurrentApplication ? Visibility.Collapsed : Visibility.Visible;\n\n base.OnNavigatedTo(e);\n}\n\n\nprivate async void OnUseAppAsBackgroundClick(object sender, RoutedEventArgs e)\n{\n LockScreenRequestResult result = await LockScreenManager.RequestAccessAsync();\n\n if (result == LockScreenRequestResult.Denied)\n MessageBox.Show(\"Unable to set this app as lock screen background provider.\");\n else\n MessageBox.Show(\"The app is lock screen background provider now.\");\n\n UseAppAsBackground.Visibility = LockScreenManager.IsProvidedByCurrentApplication ? Visibility.Collapsed : Visibility.Visible;\n}![\"Управление](\"https://blog.zwezdin.com/2013/windows-phone-lock-screen-part1/e911b081/3@2x.jpg\")
\n\n\n\n\n\n\n\n ![\"Управление](\"https://blog.zwezdin.com/2013/windows-phone-lock-screen-part1/109560ed/4@2x.jpg\")
\n\n\n\n\nПерейдем к странице настроек фонового изображения. Разместим несколько кнопок, каждая из которых будет устанавливать собственное изображение в качестве фона экрана блокировки. Обработчик нажатия по такой кнопке будет иметь следующий код:
\nprivate void OnSetBackround1Click(object sender, RoutedEventArgs e)\n{\n if (LockScreenManager.IsProvidedByCurrentApplication == true)\n LockScreen.SetImageUri(new Uri(\"ms-appx:///LockScreen1.jpg\"));\n}При этом в проект следует добавить изображения, путь до которых указывается в методе SetImageUri (Build Action = Content).
![\"Управление](\"https://blog.zwezdin.com/2013/windows-phone-lock-screen-part1/9616659b/5@2x.jpg\")
\n\n\n\n\nТаким образом, приложение готово к тому, чтобы устанавливать фоновое изображение экрана блокировки.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2013/windows-phone-lock-screen-part1/570871a1/windows_phone-lock-screen-part1@cover.jpg" }, { "id": "https://blog.zwezdin.com/2013/windows-phone-voice-commands/", "url": "https://blog.zwezdin.com/2013/windows-phone-voice-commands/", "title": "Голосовые команды в Windows Phone 8 (speech-to-text)", "date_published": "2013-01-02T12:00:00.000Z", "content_html": "Одним из значительных улучшений в Windows Phone 8 является голосовое управление устройством. Пользователь может позвонить кому-либо или открыть нужное приложение, используя голосовые команды.
\nПо умолчанию эта возможность присутствует для всех приложений. Для того, чтобы запустить приложение нужно удерживать аппаратную кнопку Windows и после появления диалога сказать, например: Открыть календарь. Аналогично можно запускать и другие приложения, называя его имя. В большинстве случаев этого достаточно. Тем не менее, разработчики приложений имеют возможность расширить эту функциональность для своего приложения, определяя новые действия при использовании голосовых команд.
Для того, чтобы добавить возможности голосового управления необходимо разрешить следующие возможности: ID_CAP_NETWORKING, ID_CAP_MICROPHONE, ID_CAP_SPEECH_RECOGNITION (как и в случае с простым распознованием речи).
![\"Голосовые](\"https://blog.zwezdin.com/2013/windows-phone-voice-commands/8e06e16e/1@2x.png\")
\n\n\n\n\nТеперь нам следует определить список команд, которые будет обрабатывать наше приложение. Команда должна содержать имя приложения и последующую фразу для определения необходимого действия. Для того, чтобы добавить обработку команд, необходимо создать словарь команд, который является XML-файлом с определенной схемой. Для создания такого словаря можно воспользоваться готовым шаблоном Voice Command Definition:
![\"Голосовые](\"https://blog.zwezdin.com/2013/windows-phone-voice-commands/e766f50d/2@2x.png\")
\n\n\n\n\n<VoiceCommands xmlns=\"http://schemas.microsoft.com/voicecommands/1.0\">\n <CommandSet xml:lang=\"en-US\">\n <CommandPrefix>Contoso Rodeo</CommandPrefix>\n <Example> play a new game </Example>\n\n <Command Name=\"PlayGame\">\n <Example> play a new game </Example>\n <ListenFor> [and] play [a] new game </ListenFor>\n <ListenFor> [and] start [a] new game </ListenFor>\n <Feedback> Starting a new game... </Feedback>\n <Navigate />\n </Command>\n\n <Command Name=\"PlayLevel\">\n <Example> replay level two </Example>\n <ListenFor> replay level {number} </ListenFor>\n <Feedback> Going to level {number}... </Feedback>\n <Navigate />\n </Command>\n\n <Command Name=\"PlayUnknownLevel\">\n <Example> replay level two </Example>\n <ListenFor> [and] replay level {*} </ListenFor>\n <Feedback> Unknown level; going to level selection... </Feedback>\n <Navigate Target=\"LevelSelect.xaml\" />\n </Command>\n\n <PhraseList Label=\"number\">\n <Item> one </Item>\n <Item> two </Item>\n <Item> three </Item>\n </PhraseList>\n\n </CommandSet>\n</VoiceCommands>Словарь голосовых команд содержит набор элементов CommandSet, каждый из которых описывает соответствующую команду. Элемент CommandSet внутри себя содержит элементы CommandPrefix (фраза, которая произносится перед командой, обычно это – имя приложения), Example (фраза, которая отображается в подсказке) и Command (содержит описание команды). Элемент Command – самый важный, в нем описывается структура голосовой команды. Внутри этого элемента присутствуют элементы Example (подсказка), ListenFor (фраза команды), Feedback (фраза, которая отображается пользователю, когда команда выполняется) и Navigate (адрес страницы, которая будет отображаться, если нужно запускать приложение не с главной страницы).
Элемент ListenFor определяет фразу, которую нужно произнести для выполнения команды. Таких фраз может быть несколько.
Содержимое элемента ListenFor имеет свои особенности. Во-первых, можно определять необязательные слова в фразе. Такие слова заключаются в квадратные скобки. Например, запись [with] show text означает, что слово with может быть произнесено, а может быть и пропущено.
Другой особенностью элемента ListenFor является то, что в конкретном месте фразы мы можем определить словарь допустимых слов. Для этого в тексте команды вставляется имя словаря, заключенного в фигурные скобки {number}. При этом, после элемента Command, мы должны определить элемент PhraseList, где будут указаны допустимые значения.
<Command ...>\n <!-- ... -->\n</Command>\n\n<PhraseList Label=\"number\">\n <Item> one </Item>\n <Item> two </Item>\n <Item> three </Item>\n</PhraseList>При необходимости мы можем изменить содержимое этого словаря из кода:
\nawait VoiceCommandService.InstalledCommandSets[\"myCommandSet\"].UpdatePhraseListAsync(\"number\", new[] { \"first\", \"second\" });В данном случае мы выбираем из всех наборов команд (CommandSets) набор с именем myCommandSet. Чтобы задать это имя, необходимо указать атрибут Name в XML-словаре голосовых команд для элемента CommandSet:
<CommandSet xml:lang=\"en-US\" Name=\"myCommandSet\">Метод UpdatePhraseListAsync выполняет обновление словаря возможных фраз для выбранного CommandSet, при это имя словаря задается первым параметром этого метода.
Для того, чтобы голосовые команды заработали для приложения, необходимо зарегистрировать словарь при первом запуске приложения:
\nprivate async void InitializeVoiceCommands()\n{\n if (VoiceCommandService.InstalledCommandSets.Any() == false)\n {\n await VoiceCommandService.InstallCommandSetsFromFileAsync(new System.Uri(@\"ms-appx:///VoiceCommandDefinition1.xml\"));\n }\n}Вызов этого метода можно добавить, например, в метод InitializePhoneApplication, который находится в файле App.xaml.cs. Теперь после первого запуска, можно запускать приложение, используя описанные в словаре команды. Для того, чтобы обработать конкретную команду, можно переопределить метод страницы OnNavigatedTo, при вызове которого прочитать содержимое свойства NavigationContext.QueryString, где и будет находиться обработанная информация.
Помимо синтеза голосовой речи Windows Phone 8 SDK содержит API для распознования голосовой речи и голосовых комманд. В этой статье мы рассмотрим первую часть – каким образом можно распозновать отдельные слова или фразы при помощи данного API.
\nЧтобы воспользоваться услугами этого API нам необходимо разрешить следующие возможности для нашего WP8 приложения: ID_CAP_NETWORKING, ID_CAP_MICROPHONE, ID_CAP_SPEECH_RECOGNITION.
![\"Распознование](\"https://blog.zwezdin.com/2012/windows-phone-speech-to-text/46eb88c1/1@2x.png\")
\n\n\n\n\nРазрешение ID_CAP_NETWORKING нужно из-за того, что процесс распознования происходит не на устройстве, а в облаке. Поэтому для пользования этой возможностью вам необходимо иметь подключение к сети.
Список поддерживаемых для распознования языков определен в специальном словаре, который доступен при обращении к свойству InstalledSpeechRecognizers.All. Разместим на странице ListPicker, содержащий все поддерживаемые языки, а также кнопку для запуска распознования текста:
<toolkit:ListPicker x:Name=\"Recognizers\">\n <toolkit:ListPicker.ItemTemplate>\n <DataTemplate>\n <StackPanel Orientation=\"Horizontal\">\n <TextBlock Text=\"{Binding DisplayName}\"/>\n <TextBlock Text=\"-\" Margin=\"5,0\"/>\n <TextBlock Text=\"{Binding Language}\"/>\n </StackPanel>\n </DataTemplate>\n </toolkit:ListPicker.ItemTemplate>\n <toolkit:ListPicker.FullModeItemTemplate>\n <DataTemplate>\n <StackPanel Margin=\"0,0,0,20\">\n <TextBlock Text=\"{Binding DisplayName}\"/>\n <TextBlock Text=\"{Binding Language}\"/>\n </StackPanel>\n </DataTemplate>\n </toolkit:ListPicker.FullModeItemTemplate>\n</toolkit:ListPicker>\n\n<Button Click=\"OnListenClick\">Listen</Button>Заполним ListPicker информацией о доступных языках:
Recognizers.ItemsSource = InstalledSpeechRecognizers.All;Простейший код для распознования будет выглядеть вот так:
\nprivate async void OnListenClick(object sender, RoutedEventArgs e)\n{\n SpeechRecognizerUI recognizer = new SpeechRecognizerUI();\n\n recognizer.Recognizer.SetRecognizer((SpeechRecognizerInformation)Recognizers.SelectedItem);\n\n SpeechRecognitionUIResult result = await recognizer.RecognizeWithUIAsync();\n if (result.ResultStatus == SpeechRecognitionUIStatus.Succeeded)\n {\n MessageBox.Show(result.RecognitionResult.Text);\n }\n}При нажатии на кнопку появится окно операционной системы, указывающее на распознование речи. Это окно имеет ряд настроек, которые можно изменять из кода приложения. Доступны они через свойство Settings объекта SpeechRecognizerUI:
ListenText - заголовок окна распознования речи;ExampleText - пример того, что пользователь может сказать устройству (например, “да/нет” на односложный вопрос);ShowConfirmation - устанавливает, необходимо ли отображать подтверждение об успешности распознования (если опция отключена, то приложение должно само взять на себя обязанность об уведомлении пользователя в случае неудачи);ReadoutEnabled - устанавливает, необходимо ли зачитывать фразу после распознования.Пример кода, в котором задаются параметры диалогового окна распознования:
\nprivate async void OnListenClick(object sender, RoutedEventArgs e)\n{\n SpeechRecognizerUI recognizer = new SpeechRecognizerUI();\n recognizer.Settings.ExampleText = \"Fine\";\n recognizer.Settings.ListenText = \"How are you?\";\n recognizer.Settings.ReadoutEnabled = false;\n recognizer.Settings.ShowConfirmation = false;\n\n recognizer.Recognizer.SetRecognizer((SpeechRecognizerInformation)Recognizers.SelectedItem);\n\n SpeechRecognitionUIResult result = await recognizer.RecognizeWithUIAsync();\n if (result.ResultStatus == SpeechRecognitionUIStatus.Succeeded)\n {\n MessageBox.Show(result.RecognitionResult.Text);\n }\n}Если логика приложения не требует отображения системного окна распознования речи можно заменить использование метода RecognizeWithUIAsync на RecognizeAsync, которое доступно через свойство Recognizer.
private async void OnListenWitoutDialogClick(object sender, RoutedEventArgs e)\n{\n SpeechRecognizerUI recognizer = new SpeechRecognizerUI();\n recognizer.Settings.ExampleText = \"Fine\";\n recognizer.Settings.ListenText = \"How are you?\";\n recognizer.Settings.ReadoutEnabled = false;\n recognizer.Settings.ShowConfirmation = false;\n\n recognizer.Recognizer.SetRecognizer((SpeechRecognizerInformation)Recognizers.SelectedItem);\n\n SpeechRecognitionResult result = await recognizer.Recognizer.RecognizeAsync();\n MessageBox.Show(result.Text);\n}Если логика приложения предполагает в качестве результата одну из нескольких заранее предопределенных фраз, то можно определить свой словарь, который будет использоваться при распозновании. Задать собственный словарь можно через свойство Recognizer.Grammars:
SpeechRecognizerUI recognizer = new SpeechRecognizerUI();\n// ...\nrecognizer.Recognizer.Grammars.AddGrammarFromList(\"MyGrammar\", new[] { \"fine\", \"bad\" });\n\nSpeechRecognitionUIResult result = await recognizer.RecognizeWithUIAsync();В итоге мы получили приложение, способное распозновать голосовую речь в рамках нашего приложения:
\n\n\n\n![\"Распознование](\"https://blog.zwezdin.com/2012/windows-phone-speech-to-text/45b2715a/2@2x.jpg\")
\n\n\n\n\n\n\n\n ![\"Распознование](\"https://blog.zwezdin.com/2012/windows-phone-speech-to-text/3f237c44/3@2x.jpg\")
",
"tags": [
"Windows Phone"
],
"banner_image": "https://blog.zwezdin.com/2012/windows-phone-speech-to-text/3a85250e/windows_phone-speech-to-text@cover.png"
},
{
"id": "https://blog.zwezdin.com/2012/windows-phone-text-to-speech/",
"url": "https://blog.zwezdin.com/2012/windows-phone-text-to-speech/",
"title": "Синтез голосовой речи из текста в Windows Phone 8 (text-to-speech)",
"date_published": "2012-11-09T12:00:00.000Z",
"content_html": "С выходом Windows Phone 8 SDK появилась возможность управлять устройством голосом. Для того, чтобы это стало возможным необходимо две вещи — распознование голосовых команд (чтобы пользователь мог управлять устройством) и синтез голосовой речи из текста (чтобы устройство могло озвучить результат).
\nЧтобы использовать возможности работы с речью необходимо установить ID_CAP_SPEECH_RECOGNITION capability в манифесте проекта:
![\"Синтез](\"https://blog.zwezdin.com/2012/windows-phone-text-to-speech/b21193dd/1@2x.png\")
\n\n\n\n\nДля синтеза речи в WP8 используется объект SpeechSynthesizer. Самый простой вариант генерации голосовой речи состоит из двух строк кода:
private async void OnSayButtonClick(object sender, RoutedEventArgs e)\n{\n SpeechSynthesizer speech = new SpeechSynthesizer();\n await speech.SpeakTextAsync(Content.Text);\n}Голос, который будет использоваться в этом случае будет определяться исходя из региональных настроек устройства. При необходимости можно изменить используемый голос, при этом выбрать национальность и пол говорящего. Список всех голосов можно получить через статическое свойство InstalledVoices.All.
Разместим ListPicker на странице:
<toolkit:ListPicker x:Name=\"Voices\">\n <toolkit:ListPicker.ItemTemplate>\n <DataTemplate>\n <StackPanel Orientation=\"Horizontal\">\n <TextBlock Text=\"{Binding DisplayName}\"/>\n <TextBlock Text=\"-\" Margin=\"5,0\"/>\n <TextBlock Text=\"{Binding Language}\"/>\n </StackPanel>\n </DataTemplate>\n </toolkit:ListPicker.ItemTemplate>\n <toolkit:ListPicker.FullModeItemTemplate>\n <DataTemplate>\n <StackPanel Margin=\"0,0,0,20\">\n <TextBlock Text=\"{Binding DisplayName}\"/>\n <TextBlock Text=\"{Binding Language}\"/>\n <TextBlock Text=\"{Binding Gender}\"/>\n </StackPanel>\n </DataTemplate>\n </toolkit:ListPicker.FullModeItemTemplate>\n</toolkit:ListPicker>И заполним его списком установленных голосов:
\nVoices.ItemsSource = InstalledVoices.All;Для того, чтобы использовать выбранный голос при синтезе речи необходимо вызвать метод SetVoice для объекта SpeechSynthesizer:
private async void OnSayButtonClick(object sender, RoutedEventArgs e)\n{\n string content = Content.Text;\n\n SpeechSynthesizer speech = new SpeechSynthesizer();\n speech.SetVoice((VoiceInformation)Voices.SelectedItem);\n await speech.SpeakTextAsync(content);\n}На этом мы получили приложение, которое воспроизводит заданный текст:
\n\n\n\n![\"Синтез](\"https://blog.zwezdin.com/2012/windows-phone-text-to-speech/47fa8811/2@2x.jpg\")
\n\n\n\n\nДля более точной настройки речи можно воспользоваться специальным языком SSML (Speech Synthesis Markup Language), который также поддерживается в WP8. Для этого у объекта SpeechSynthesizer поддерживаются два метода – SpeakSsmlAsync (проигрывает SSML из текстовой переменной) и SpeakSsmlFromUriAsync (проигрывает SSML из файла).
private async void OnSaySsmlButtonClick(object sender, RoutedEventArgs e)\n{\n SpeechSynthesizer speech = new SpeechSynthesizer();\n await speech.SpeakSsmlAsync(@\"<speak version=\"\"1.0\"\" xmlns=\"\"http://www.w3.org/2001/10/synthesis\"\" xml:lang=\"\"ru-Ru\"\">\n <voice gender=\"\"female\"\">\n Здравствуйте, Александр!<break/>\n Рада вас видеть!\n </voice>\n\n <voice gender=\"\"male\"\">\n Здравствуйте, Ирина! И я очень рад.\n </voice>\n </speak>\");\n}Известно, что концепция приложений WP7 включает в себя страницы. Адреса страниц в приложении формируются исходя из физического положения страницы в проекте. В этой заметке я расскажу про объект UriMapper, который позволяет задать адрес страницы независимо от размещения страницы в проекте.
Представим, что в приложении имеется несколько страниц. Для перехода от одной странице к другой следует воспользоваться объектом NavigationService и указать адрес страницы, к которой мы хотим перейти:
NavigationService.Navigate(new Uri(\"<strong>/SettingsPage.xaml</strong>\", UriKind.Relative));Адрес страницы формируется из ее названия и расположения внутри проекта. Так, например, если мы поместим эту страницу в подпапку Pages, то адрес страницы изменится на /Pages/SettingsPage.xaml; при переносе страницы в другую сборку, адрес также будет изменен.
Эта проблема оказывается действительно неприятной, когда пересматривается структура папок проекта, а то и структура самого проекта. Самое неприятное в этой ситуации то, что при наличии какой-то более-менее сложной навигации можно просто упустить из виду некоторые вызовы NavigationService и допустить ошибку в приложении. Visual Studio и компилятор такие ошибки отловить не смогут. Как результат, при переходе по адресу несуществующей странице приложение просто завершится.
Для того, чтобы этого избежать можно использовать объект UriMapper, который позволяет определить адреса страниц независимо от их расположения в проекте. Фактически, мы задаем некоторый алиас для страницы и используем именно его для перехода на страницы. В этом случае при пересмотре структуры проекта нужно будет только сменить настройки для преобразования алиасов в реальные адреса страницы.
Для того, чтобы использовать UriMapper в своем приложении нужно выполнить следующие действия:
Шаг 1: Создать и определить настройки объекта UriMapper. Обычно я это делаю в ресурсах приложения, в файле App.xaml. Естественно, это совсем необязательно.
<Application.Resources>\n <phone:UriMapper x:Name=\"ApplicationUriMapper\">\n <phone:UriMapping Uri=\"/Home\" MappedUri=\"/Views/MainPage.xaml\"/>\n <phone:UriMapping Uri=\"/Session/{ID}\" MappedUri=\"/Views/Session.xaml?ID={ID}\"/>\n <phone:UriMapping Uri=\"/Sessions\" MappedUri=\"/Views/SessionTracks.xaml\"/>\n <phone:UriMapping Uri=\"/About\" MappedUri=\"/Views/About.xaml\"/>\n </phone:UriMapper>\n</Application.Resources>Шаг 2: Указать приложению, что нужно использовать данный UriMapper. Для этого при инициализации приложения необходимо задать свойство UriMapper для объекта PhoneApplicationFrame. Понятно, что здесь можно сконструировать объект UriMapper, но поскольку он у нас уже определен в ресурсах, то возьмем его прямо оттуда:
private void InitializePhoneApplication()\n{\n if (phoneApplicationInitialized)\n return;\n\n RootFrame = new PhoneApplicationFrame();\n RootFrame.UriMapper = (UriMapper)Resources[\"ApplicationUriMapper\"];Шаг 3: Использовать в качестве адресов указанные алиасы:
\nNavigationService.Navigate(new Uri(\"<strong>/About</strong>\", UriKind.Relative));При определении адресов можно пользоваться шаблонами. Например, при определении UriMapper выше используется алиас /Session/{ID}, значение параметра ID потом подставляется в конечный адрес. Аналогично можно использовать несколько параметров.
Используя такой несложный прием вы можете избежать проблем с путаницей адресов страниц в будущем, если потребуется изменить структуру страницы.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2011/windows-phone-urimapper/5b3d70e9/windows_phone-urimapper@cover.jpg" }, { "id": "https://blog.zwezdin.com/2011/windows-phone-gesture-service/", "url": "https://blog.zwezdin.com/2011/windows-phone-gesture-service/", "title": "Как использовать GestureService и добавить обработчики жестов из кода", "date_published": "2011-11-24T12:00:00.000Z", "content_html": "В Windows Phone 7 Toolkit доступен объект для обработки жестов – GestureService. Как известно, этот сервис позволяет обрабатывать стандартные для Windows Phone 7 жесты. Однако, многие примеры использования GestureService сводятся к применению его в XAML. В этой небольшой заметке я покажу как использовать GestureService из кода.
Для начала работы нам необходимо подключить Windows Phone 7 Toolkit к проекту. Для этого нужно добавить ссылку на сборку Microsoft.Phone.Controls.Toolkit.dll.
GestureService из кодаДля использования GestureService из кода, нам нужно получить доступ к объекту GestureListener, который будет ассоциирован с некоторой областью на экране. В рамках этой области (source) будут отслеживаться наши жесты.
var listener = GestureService.GetGestureListener(source);Объект GestureListener готов к работе, теперь можно обрабатывать его жесты.
Для обработки конкретного жеста следует подписаться на соответствующее событие объекта GestureListener:
listener.Tap += OnTapHandler;Безусловно можно подписаться и на другие жесты, используя аналогичный подход.
\nПодписываться на события жестов можно в любой момент после создания соответствующих элементов управления. Например, это можно делать в конструкторе страницы (конечно, более правильно это делать во ViewModel, но сейчас мы не будем усложнять пример). Например, следующий код создает новый элемент управления (Rectangle) на странице и добавляет для него обработчик жестов.
public partial class Page1 : PhoneApplicationPage\n{\n Rectangle _source;\n\n public MainPage()\n {\n InitializeComponent();\n _source = new Rectangle {Height = 200, Width = 200, Fill = new SolidColorBrush(Colors.Green)};\n ContentPanel.Children.Add(_source);\n\n var listener = GestureService.GetGestureListener(_source);\n listener.Tap += OnTapHandler;\n }\n\n private void OnTapHandler(object sender, GestureEventArgs e)\n {\n _source.Fill = new SolidColorBrush(Colors.Yellow);\n }\n}Многие устройства на Windows Phone 7 имеют встроенный компас. В последнем обновлении инструментов разработчика для Windows Phone появился API для работы с компасом.
\nВ качестве базового объекта для работы с компасом используется сенсор Compass. Как можно увидеть, этот объект унаследован от SensorBase – базового объекта для всех сенсоров в Windows Phone 7. Не все устройства имеют компас, поэтому перед началом работы следует проверить, имеет ли данное устройство компас. Общая последовательность действий для работы с компасом такова:
Compass.Для проверки доступности компаса в устройстве используется статическое свойство IsSupported объекта Compass:
if (Compass.IsSupported == true)Если компас доступен, то создается объект и запускается прослушивание сенсора. При каждом изменении значения сенсора генерируется событие CurrentValueChanged. В обработчике этого события можно получить доступ к объекту CompassReading, который содержит текущее направление компаса.
Следующий код выполняет описанные выше действия:
\nprivate Compass _compass;\n\npublic MainPage()\n{\n InitializeComponent();\n\n if (Compass.IsSupported == true)\n {\n _compass = new Compass();\n _compass.CurrentValueChanged += ComapssValueChanged;\n _compass.Start();\n\n }\n else\n MessageBox.Show(\"Compass is not supported.\");\n\n}\n\nprivate void ComapssValueChanged(object sender, SensorReadingEventArgs<CompassReading> e)\n{\n Dispatcher.BeginInvoke(() =>\n {\n info.Text = e.SensorReading.TrueHeading.ToString();\n });\n}Рассказывая друзьям про Office 365 и его преимущества я очень часто слышу вопрос о том, как привязать к нему собственный домен. С этой проблемой я столкнулся и сам, когда мигрировал на купленный аккаунт Office 365. К сожалению, в то время (а было это буквально через несколько дней после запуска) не было подробной документации о привязке собственного домена. Тем не менее, стандартный домен использовать не хотелось. Поэтому пришлось решать вопрос экспериментальным путем. Не исключено, что на данный момент такой раздел в документации добавили. Тем не менее, в этом посте я кратко опишу действия, которые нужно выполнить (хотя бы для того, чтобы давать эту ссылку друзьям в ответ на соответствующий вопрос).
\nИтак, первое что вам необходимо сделать – зарегистрировать аккаунт в Office 365. Для этого идем по ссылке и выбираем Free Trial. В принципе, можно сразу и купить аккаунт, но если вы выбираете режим Trial, то его без проблем можно будет превратить в платный аккаунт позже. После заполнения всех необходимых сведений мы получаем доступ и возможность пользоваться сервисом в домене ".onmicrosoft.com".
Проверка домена необходима для того, чтобы удостовериться, что именно вы являетесь владельцем домена. Для проверки вашего домена вас попросят добавить тестовую запись TXT (или MX – на ваш выбор) в DNS вашего домена.
\nЧтобы выполнить проверку домена, входим в панель управления аккаунтом Office 365 и выбираем пункт “Add and verify your domain”.
\n\n\n\n![\"Привязка](\"https://blog.zwezdin.com/2011/office365-custom-domain/bb02b9ec/step-1-1@2x.png\")
\n\n\n\n\nПосле указания имени домена вам предоставят содержимое записи, которую следует внести в настройки домена, а также все шаги по их выполнению в зависимости от регистратора.
\n\n\n\n![\"Привязка](\"https://blog.zwezdin.com/2011/office365-custom-domain/b9112887/step-1-2@2x.png\")
\n\n\n\n\nВносим соответствующую запись в настройки домена и ждем некоторое время, чтобы они успели примениться. После того, как записи в DNS обновились, домен появится в списке доменов Office 365.
\nТеперь необходимо выбрать режим привязки домена.
\nПо умолчанию, Office 365 предложит использовать свои Name Servers для вашего домена (в моем случае это были ns1.bdm.microsoftonline.com и ns2.bdm.microsoftonline.com). Если этот вариант вас устраивает, то идем к настройкам домена и изменяем Name Servers на предложенные. После этого у вас должно все заработать и никаких других действий по настройке домена выполнять не нужно.
Меня такой вариант не устроил, поскольку мне удобно использовать в качестве Name Server другой сервер. Если вам тоже, то читаем дальше.
\nДля того, чтобы использовать собственный Name Server, но при этом пользоваться Office 365 нужно добавить несколько записей в настройки домена. Для этого переходим во вкладку “Domains” и выбираем “DNS Manager”.
\n\n\n\n![\"Привязка](\"https://blog.zwezdin.com/2011/office365-custom-domain/8ffb831b/step-3-1@2x.png\")
\n\n\n\n\nDNS Manager содержит настройки для вашего домена. Если вы используете предложенные во втором шаге Name Servers, то именно здесь вы сможете управлять записями для своего домена. Сейчас эта информация пригодится нам для добавления соответствующих записей для своего домена.
\n\n\n\n![\"Привязка](\"https://blog.zwezdin.com/2011/office365-custom-domain/4854d081/step-3-2@2x.png\")
\n\n\n\n\nВсе что необходимо сделать – добавить аналогичные записи для своего домена.
\nПосле выполнения этих действий нужно подождать некоторое время, чтобы настройки успели примениться. После этого можно пользоваться Office 365, но уже со своим доменом.
\nКстати, в Trial-режиме тоже можно привязать собственный домен и проверить как все будет работать.
", "tags": [ "Tips&Tricks" ], "banner_image": "https://blog.zwezdin.com/2011/office365-custom-domain/9c621f84/office365_custom-domain@cover.png" }, { "id": "https://blog.zwezdin.com/2011/windows-phone-state-restore/", "url": "https://blog.zwezdin.com/2011/windows-phone-state-restore/", "title": "Быстрое восстановление состояния приложения Windows Phone 7.5", "date_published": "2011-11-02T12:00:00.000Z", "content_html": "Модель исполнения приложений Windows Phone 7 устроена так, что после деактивации приложения оно может быть выгружено из памяти. Поэтому при повторном обращении к приложению оно должно восстановить свое состояние. В некоторых случаях восстановление состояние при повторном обращении к приложению может занимать длительное время. Поэтому в Mango появилась возможность быстрого восстановления состояния.
\nКак известно, восстановление состояния происходит в обработчике события Application.Activated. Если приложение было выгружено недавно и ОС не успела выгрузить его состояние из памяти, то восстанавливать состояние необязательно. Для отслеживания таких ситуаций был добавлен специальный флаг IsApplicationInstancePreserved. Если значение этого флага установлено в true, то можно пропустить этап восстановления состояния:
private void Application_Activated(object sender, ActivatedEventArgs e)\n{\n if (e.IsApplicationInstancePreserved == false)\n {\n // restore state\n }\n else\n {\n // ignore state restoring\n }\n}Жесты являются одним из ключевых способов взаимодействия пользователя и приложения в Windows Phone 7. Это стало возможным благодаря наличию мультитач экранов с 4 касаниями (как минимум) во всех аппаратах на Windows Phone 7. Стандартные элементы управления уже содержат обработчики жестов. Однако, иногда необходимо добавить собственную логику для обработки жестов. В этой заметке будет рассказано о том, как добавить свою логику обработки жестов за несколько шагов.
\nСписок всех доступных жестов подробно описан в соответствующем разделе MSDN, вот только некоторые, наиболее популярные из них:
\n\n\n\n![\"Нажатие](\"https://blog.zwezdin.com/2011/windows-phone-gestures/381f8f69/1@2x.png\")
![\"Двойное](\"https://blog.zwezdin.com/2011/windows-phone-gestures/cb050042/2@2x.png\")
![\"Нажатие](\"https://blog.zwezdin.com/2011/windows-phone-gestures/5799b0fc/3@2x.png\")
Для обработки манипуляций каждый элемент управления имеет три события:
\nManipulationStarted – генерируется при начале выполнения какого-либо жеста;ManipulationDelta – генерируется периодически в процессе выполнения жеста (позволяет отследить относительное смещение);ManipulationCompleted – генерируется в момент завершения жеста (пользователь оторвал пальцы от экрана).Можно построить несложную математическую модель для отслеживания жестов на основе этих событий. Однако, более простой способ обрабатывать жесты — использовать объект GestureService из Windows Phone 7 Toolkit. Этот объект отслеживает стандартные жесты и позволяет подписаться на соответствующие события.
Для использования GestureService следует добавить ссылку на сборку Microsoft.Phone.Controls.Toolkit.dll, в которой и находится нужный объект. После этого следует добавить соответствующее пространство имен в определение страницы:
xmlns:toolkit=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Toolkit\"Теперь можно добавить обработку жестов для элементов управления. Например, создадим элемент Rectangle и добавим обработку жеста Hold:
<Rectangle Fill=\"Green\">\n <toolkit:GestureService.GestureListener>\n <toolkit:GestureListener Hold=\"OnHoldHandler\" />\n </toolkit:GestureService.GestureListener>\n</Rectangle>В коде страницы должен быть обработчик с именем OnHoldHandler:
private void GestureListener_Hold(object sender, GestureEventArgs e)\n{\n // ...\n}Теперь при обнаружении жеста Hold будет срабатывать заданный обработчик.
Не всегда мобильное приложение удается сделать экономичным по отношению к батарее. Яркий пример таких приложений — автомобильная навигация. В этом случае для предотвращения быстрого разряда батареи следует использовать внешнее питание. Здесь я покажу каким образом отслеживать такие ситуации.
\nВ случаях, когда сценарии использования нашего приложения предполагают наличие внешнего питания, следовало бы предупредить пользователя об этом. Напрашивается следующая логика: перед запуском ресурсоемкого программного кода мы должны проверить присутствует ли внешний источник питания и, если нет, то предупредить пользователя о том, что батарея может быть быстро истощена. То же самое следует проделывать всякий раз, когда внешнее питание отключается.
\nЭту логику просто реализовать, используя класс DeviceStatus. Для наших целей он содержит:
PowerSource – позволяет определить текущий источник питания (батарея или внешний);PowerSourceChanged – позволяет отловить момент, когда источник питания изменяется.Теперь мы можем построить требую для нас логику. Предположим, что у нас есть два метода – StartWorkingHard() и StopWorkingHard(), которые запускают и останавливают запись GPS-трека. Тогда код для отслеживания источника питания может выглядеть так:
public MainPage()\n{\n InitializeComponent();\n\n DeviceStatus.PowerSourceChanged += PowerSourceChanged;\n CheckPowerStatus();\n}\n\nprivate void PowerSourceChanged(object sender, EventArgs e)\n{\n CheckPowerStatus();\n}\n\nprivate void CheckPowerStatus()\n{\n if (DeviceStatus.PowerSource == PowerSource.Battery)\n {\n if (MessageBox.Show(\"Используется питание от батареи. Продолжить запись трека?\", \"Изменен источник питания\", MessageBoxButton.OKCancel) == MessageBoxResult.OK)\n {\n StartWorkingHard();\n }\n else\n StopWorkingHard();\n }\n else\n StartWorkingHard();\n}\n\nprivate void StartWorkingHard()\n{\n}\n\nprivate void StopWorkingHard()\n{\n}Любые мобильные приложения ограничены в ресурсах. Поэтому производителю мобильных ОС приходится заботиться о том, чтобы приложения корректно исполнялись во всех конфигурациях. Одним из таких ограничений является ограничение в 90Мб используемой оперативной памяти для устройств с ОЗУ 256 Мб (Technical Certification Requirements - 5.2.5 Memory Consumption). Здесь я покажу как определить объем ОЗУ у текущего устройства.
\nКак следует из описания этого требования, приложение не должно потреблять больше 90Мб оперативной памяти; это требование не распространяется на устройства, имеющие больше 256Мб ОЗУ.
\n\n\nAn application must not exceed 90 MB of RAM usage, except on devices that have more than 256 MB of memory.
\n
Становится понятно, что в случае, если устройство менее малый объем памяти нужно как-то ограничить аппетиты приложения, например, выключить дополнительную анимацию, графику и другие ресурсы, потребляющие ОЗУ, но не влияющие на функциональности. Безусловно, в этом случае пользователь может получить менее красивое приложение, но зато оно хотя бы будет работать.
\nДля определения этой информации следует использовать объект DeviceStatus (для WP 7.0 следует использовать объект DeviceExtendedProperties). Этот объект содержит свойство DeviceTotalMemory, которое содержит общий объем ОЗУ устройства. Сравнивая это значение с пороговым можно определить с каким именно устройством мы имеем дело:
public static class MemoryExtensions\n{\n public static bool IsLowMemoryDevice(this Application app)\n {\n return Microsoft.Phone.Info.DeviceStatus.DeviceTotalMemory <= 256*1024;\n }\n}Большинство мобильных приложений Windows Phone 7 так или иначе работают с ресурсами из сети. Думаю, многие согласятся со мной, что WP7-устройство, не подключенное к сети не представляет особого смысла. В реальности нам не всегда доступна сеть при использовании устройства. В этом случае следует корректно обрабатывать эту ситуацию в своем приложении. Здесь я покажу простой способ как это можно сделать.
\nВ действительности для разработчика было бы хорошо иметь не только информацию о наличии сети, но и представлять какой тип сети в данный момент используется. Например, было бы неправильно загружать несколько сотен мегабайт через 3G-сеть, хотя для WiFi-сетей это, как правило, нормально. Такую функциональность предоставляет объект NetworkInterface, который расположен в пространстве имен Microsoft.Phone.Net.NetworkInformation. Следующие примеры кода позволяют получить информацию о наличии сети и ее типе.
Проверка доступности сети:
\nbool isNetworkAvailable = Microsoft.Phone.Net.NetworkInformation.NetworkInterface.GetIsNetworkAvailable();Определение типа сети:
\nNetworkInterfaceType type = Microsoft.Phone.Net.NetworkInformation.NetworkInterface.NetworkInterfaceType;Тип NetworkInterfaceType – это перечисление, которое может принимать различные значения в зависимости от типа сети:
EthernetMobileBroadbandCdmaMobileBroadbandGsmWireless80211NoneЛюбите ли вы настраивать Visual Studio под свои личные предпочтения? Форматирование кода. Темы оформления. Набор расширений. Горячие клавиши. Расположение окон и панелей инструментов. Думаю, что этим занимается каждый разработчик, который заботится о своей продуктивности и комфорте работы. В итоге каждый из нас имеет базовый пакет настроек, специфичный для текущего окружения. В этом окружении можно чувствовать себя как рыба в воде, наизусть знать все горячие клавиши, расположение панелей. А среда разработки помогает вам быть продуктивнее, форматируя код и участвуя в рефакторинге. И казалось бы, уже ничего не может нарушить этой гармонии.
\nК сожалению, эту гармонию могут нарушить банальные жизненные обстоятельства. Например, вы решили поучаствовать во внешнем проекте, в котором определены свои правила оформления кода, отличные от ваших. Или вы выступаете с докладом и вас попросили изменить цвет и увеличить размер шрифта из-за особенностей местного проектора. Знакомо, не правда ли?
\nЧто мы обычно делаем в приведенных выше ситуациях? Конечно мы открываем настройки Visual Studio и изменяем их в соответствии с нашими потребностями. В этом нет ничего плохого, если только вам не требуется это делать периодически. А как быть, если вы, например, с постоянной периодичностью читаете лекции студентам? Или переключаетесь между проектами с различными правилами оформления кода? В этих ситуациях вам потребуется постоянно изменять настройки среды разработки, что в конечном счете может стать сильно неэффективным. И в этом случае напрашивается логичное решение автоматизировать эти действия.
\nРешением проблемы могут быть два подхода:
\nРассмотрим каждый из них.
\nЭтот способ предполагает хранение на жестком диске нескольких конфигурационных файлов. Каждый файл соответствует отдельной ситуации. Получить такой конфигурационный файл очень просто – достаточно просто воспользоваться стандартным механизмом Import and Export Settings Wizard. С его помощью можно как сохранить текущие настройки в конфигурационный файл, так и восстановить состояние среды по существующему файлу.
![\"Одновременное](\"https://blog.zwezdin.com/2011/visual-studio-2010-rootsuffix/a186228b/1@2x.png\")
\n\n\n\n\nКонфигурационные файлы являются обычными файлами XML, содержащие все настройки среды, указанные при экспорте. Теоретически вы можете автоматизировать настройку Visual Studio в соответствии с какими-то собственными алгоритмами. Для этого можно просто изменять содержимое конфигурационного файла. Однако мне очень сложно придумать, в каких ситуациях это действительно может быть востребовано.
\nПосле того, как вы подготовили несколько различных конфигураций, вы можете импортировать их, когда потребуется соответствующее окружение. Но использовать упомянутый диалог Import and Export Settings Wizard всякий раз, когда вам нужно сменить окружение – лишняя трата времени. Вместо этого можно создать несколько ярлыков на рабочем столе для запуска Visual Studio и указать для каждого из них путь до конфигурационного файла:
devenv.exe /ResetSettings \"D:\\VSConfig\\settings1.vssettings\"Нетрудно догадаться, что в приведенном выше примере путь D:\\VSConfig\\settings1.vssetting как раз и указывает на конфигурационный файл. Теперь каждый ярлык Visual Studio на вашем рабочем столе запускает среду разработки с соответствующим окружением.
К плюсам данного решения можно отнести автоматизацию процесса загрузки новой конфигурации. Но такое решение обладает и рядом недостатков:
\n/ResetSettings очищаются внутренние кэши Visual Studio, что может негативно сказаться на скорости работы IDE уже в процессе написания кода;Альтернативой приведенного выше способа является использование изолированных экземпляров Visual Studio. На самом деле изолированные экземпляры были созданы с целью отладки расширений для Visual Studio – вы разрабатываете собственное расширение и запускаете отладку. В этот момент запускается изолированный экземпляр Visual Studio, настройки которого являются независимыми от основной копии Visual Studio.
\nЭтой особенностью как раз и можно воспользоваться для решения нашей задачи. Для этого нам нужно иметь несколько независимых изолированных экземпляров Visual Studio. Возможность создания изолированных экземпляров появляется после установки Visual Studio 2010 SDK. После установки SDK вам будет доступна утилита CreateExpInstance.exe, которая как раз и занимается управлением экземплярами Visual Studio.
\nДля создания нового экземпляра следует воспользоваться следующей командой:
\nCreateExpInstance.exe /VSInstance=10.0 /RootSuffix=PresentationНа самом деле эта утилита просто создает нужные ключи в реестре Windows. Параметр RootSuffix указывает имя создаваемого экземпляра. Это имя потребуется для запуска этого экземпляра. Аналогично использованию конфигурационных файлов, можно создать несколько ярлыков для запуска Visual Studio и указать параметры:
devenv.exe /RootSuffix PresentationТеперь, когда мы создали несколько изолированных экземпляров Visual Studio, мы можем запустить каждый из них и настроить соответствующее окружение, которое будет сохранено именно для этого случая.
\nПлюсы подобного подхода очевидны – мы избавляемся от всех минусов предыдущего способа, создавая для каждого окружения свою изолированную среду. К минусам этого решения можно отнести необходимость установки Visual Studio 2010 SDK и применение специальной утилиты для управления экземплярами.
\nПоднятая в этой заметке проблема может быть актуальной далеко не для всех. Но если для вас эта проблема актуальна, то лучше свести количество необходимых дополнительных действий к минимуму. На мой взгляд решение с использованием изолированных экземпляров Visual Studio более оправдано, поскольку позволяет ускорить запуск IDE по сравнению с первым способом.
\nУдачных экспериментов!
", "tags": [ "Tips&Tricks", "Visual Studio" ], "banner_image": "https://blog.zwezdin.com/2011/visual-studio-2010-rootsuffix/135afd43/visual_studio-2010-rootsuffix@cover.jpg" }, { "id": "https://blog.zwezdin.com/2011/windows-phone-reuse-resources/", "url": "https://blog.zwezdin.com/2011/windows-phone-reuse-resources/", "title": "Как задать повторно используемые ресурсы в Windows Phone 7", "date_published": "2011-06-25T12:00:00.000Z", "content_html": "Нередко в приложении требуется задать ресурсы, которые будут использоваться в различных местах приложения повторно. Это, например, могут быть фирменные цвета приложения, изображения и т.д. В этой заметке я покажу как это сделать.
\nДля каждого элемента управления Windows Phone 7 (наследника объекта FrameworkElement) существует свойство Resources, которое может содержать ресурсы для этого элемента управления. Ресурсы наследуются для вложенных элементов, т.е. для дочернего элемента управления вы можете использовать ресурсы родительского элемента. При этом каждый ресурс обладает уникальным именем – ключом.
Для всего приложения также определено свойство Resources, которое может содержать ресурсы. При этом, размещая ресурсы в этом месте, они становятся доступными для каждого элемента. Ресурсы приложения определяются в файле App.xaml следующим образом:
<phone:PhoneApplicationPage.Resources>\n <SolidColorBrush x:Key=\"TextColor\" Color=\"Green\" />\n</phone:PhoneApplicationPage.Resources>После определения глобальных ресурсов их можно использовать при описании элементов управления в приложении:
\n<TextBlock Text=\"Some text\" Foreground=\"{StaticResource TextColor}\" />Кстати, в Windows Phone 7 доступны ресурсы текущей темы, адаптируемые под визуальные настройки самой ОС. На MSDN приведен полный список ключей, которые можно использовать так же, как приведено выше.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2011/windows-phone-reuse-resources/7501ac8c/windows_phone-reuse-resources@cover.jpg" }, { "id": "https://blog.zwezdin.com/2011/windows-phone-trial-mode/", "url": "https://blog.zwezdin.com/2011/windows-phone-trial-mode/", "title": "Определение режима лицензирования приложений Windows Phone 7", "date_published": "2011-04-30T12:00:00.000Z", "content_html": "Магазин Windows Phone 7 Marketplace позволяет использовать испытательный период (Trial) для платных приложений. В этом режиме платное приложение устанавливается бесплатно, но работает в режиме ограниченной функциональности. В этой заметке я расскажу о том, как определить работает ли приложение в испытательном режиме или оно было куплено.
\nНа самом деле проблема определения режима несколько шире – разработчик должен иметь способ отладить приложения в обоих режимах – испытательном и полном. По умолчанию все приложения, запускаемые в эмуляторе работают в испытательном режиме. Поэтому создадим небольшой helper-класс, который учитывает эту ситуацию.
\nДля определения режима используется объект LicenseInformation, который расположен в пространстве имен Microsoft.Phone.Marketplace и имеет единственный метод IsTrial(). В случае, когда приложения запускается из эмулятора результатом этого метода всегда будет true. Поэтому в случае с эмулятором мы должны игнорировать этот метод и устанавливать значение самостоятельно (для получения возможности отладки для разных случаев).
Определить тип устройства (реальное устройство или эмулятор) можно из текущего окружения (свойство DeviceType из объекта Environment).
Таким образом, окончательный вид нашего метода для определения испытательного режима для мобильного приложения:
\npublic static class ThemeExtensions\n{\n private const bool IsTrialForEmulator = true;\n\n public static bool IsTrialMode(this Application app)\n {\n if (Microsoft.Devices.Environment.DeviceType == Microsoft.Devices.DeviceType.Device)\n {\n LicenseInformation license = new LicenseInformation();\n return license.IsTrial();\n }\n else\n return IsTrialForEmulator;\n }\n}Использование данного кода в приложении крайне просто:
\nbool isTrial = App.Current.IsTrialMode();Если впоследствии появится необходимость протестировать приложение в различных режимах (полном и испытательном), то нужно только изменить значение флага IsTrialForEmulator в определении приведенного выше класса.
Windows Phone 7 позволяет пользователю установить одну из тем – светлую или темную, а также задать цвет акцента. По задумке разработчиков WP7 в зависимости от этого выбора переопределяются и ресурсы приложения, а следовательно и приложение изменяет свой внешний вид. Из-за этого создаются ситуации, когда приложению необходимо определить какая тема на данный момент активна и в зависимости от этого, изменить логику. В этой заметке я покажу как можно определить текущую тему простым способом.
\nОпределить текущую тему в Windows Phone 7 очень просто. Для этого достаточно обратиться к ресурсам — ОС сама устанавливает значения соответствующих ключей в зависимости от установки текущей темы. В нашем случае интересны два ключа в ресурсах – PhoneDarkThemeVisibility и PhoneLightThemeVisibility. Каждый из этих ключей содержит объекты типа Visibility, которые устанавливаются в значение Visible или Collapsed в зависимости от того, какая тема сейчас установлена. Например, проверить установку темной темы можно следующим образом:
Visibility themeVisibility = (Visibility)Resources[\"PhoneDarkThemeVisibility\"];\nif (themeVisibility == Visibility.Visible)\n{\n // Dark theme\n}Такой способ не очень удобен для использования в различных частях приложения. Поэтому я создал небольшой класс, содержащий методы расширения объекта Application:
public static class ThemeExtensions\n{\n public static bool IsDarkTheme(this Application app)\n {\n Visibility themeVisibility = (Visibility)app.Resources[\"PhoneDarkThemeVisibility\"];\n return themeVisibility == Visibility.Visible;\n }\n\n public static bool IsLightTheme(this Application app)\n {\n Visibility themeVisibility = (Visibility) app.Resources[\"PhoneLightThemeVisibility\"];\n return themeVisibility == Visibility.Visible;\n }\n}Теперь для определения текущей темы можно использовать следующий код:
\nbool isDark = App.Current.IsDarkTheme();\nbool isLight = App.Current.IsLightTheme();Обычно шаблоны, описывающие внешний вид не нуждаются в динамическом изменении своего внешнего вида – они статически размещаются в ресурсах приложения и используются. Но для всякого правила бывают исключения, поэтому в данной заметке я покажу каким образом можно генерировать DataTemplate “на лету” в коде.
\nПредставим ситуацию, в которой нам необходимо определить DataTemplate для элементов ListBox динамически в коде (для других элементов управления процедура останется той же). Чтобы это реализовать нужно выполнить следующие шаги:
DataTemplate;ItemTemplate для элемента ListBox.Генерация XAML заключается в получении строки, содержащей валидный XML и соответствующей схеме XAML (http://schemas.microsoft.com/winfx/2006/xaml/presentation). В этом примере мы просто создадим строку с определением шаблона, однако в своем коде вы наверняка здесь добавите какую-то логику (иначе зачем вообще затевать динамическую генерацию шаблона?).
string source = @\"<DataTemplate xmlns=\"\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\"\n xmlns:x=\"\"http://schemas.microsoft.com/winfx/2006/xaml\"\">\n <Grid>\n <TextBlock Text=\"\"{Binding}\"\" FontSize=\"\"40\"\" Background=\"\"Red\"\" />\n </Grid>\n</DataTemplate>\";Для получения объекта DataTemplate на основе полученной строки следует использовать объект XamlReader. Он разбирает исходный фрагмент XAML и, если он корректен, создает на его основе объект заданного типа (таким образом, кстати, можно создавать любые объекты, а не только DataTemplate). Для разбора XAML следует выполнить метод Load() и результат привести к требуемому типу (в данном случае – DataTemplate):
DataTemplate template = (DataTemplate)XamlReader.Load(source);Будьте осторожны, если в исходной строке содержаться ошибки (например, недопустимые символы), то вы получите ошибку времени исполнения. По-хорошему, такие ситуации следует явно отслеживать в коде и соответствующе на них реагировать.
\nПоследнее, что необходимо сделать – присвоить полученный объект DataTemplate свойству ItemTemplate элемента ListBox. Результирующий код будет выглядеть так:
string source = @\"<DataTemplate xmlns=\"\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\"\n xmlns:x=\"\"http://schemas.microsoft.com/winfx/2006/xaml\"\">\n <Grid>\n <TextBlock Text=\"\"{Binding}\"\" FontSize=\"\"40\"\" Background=\"\"Red\"\" />\n </Grid>\n</DataTemplate>\";\n\nDataTemplate template = (DataTemplate)XamlReader.Load(source);\n\nListBox1.ItemTemplate = template;\nListBox1.ItemsSource = ...;Очень часто в приложении Windows Phone 7 требуется разделить функциональность приложения на несколько сборок. И в этом случае часто возникают вопросы – как использовать страницу (XAML), расположенную не в основной сборке. Мне пришло несколько вопросов подобного характера в почту, отвечаю здесь всем сразу.
\nЗа навигацию в Windows Phone 7 отвечает объект NavigationService. Он содержит методы Navigate() и GoBack(), которые позволяют перемещаться по страницам и изменять содержимое стека навигации. Важным моментом при этом является то, что для адресации страницы используется объект Uri (при этом все пути к страницам – относительные).
Типичный пример кода для перехода на страницу в основной сборке выглядит так:
\nNavigationService.Navigate(new Uri(\"/About.xaml\", UriKind.Relative));В данном случае методу Navigate() передается объект Uri, который и содержит путь до нужной страницы.
Для навигации на страницы, расположенные во внешней сборки необходимо:
\nС первым пунктом все достаточно просто – нужно добавить ссылку (Add Reference) на сборку, содержащую требуемую страницу. Для указания адреса страницы следует воспользоваться стандартным для приложений Silverlight синтаксисом и указать имя сборки:
NavigationService.Navigate(new Uri(\"/Project1;component/MyPage.xaml\", UriKind.Relative));Путь до страницы внутри сборки может быть вложенным:
\nNavigationService.Navigate(new Uri(\"/Project1;component/Views/Part1/Page1.xaml\", UriKind.Relative));Аналогичным образом можно делать ссылки из элемента управления HyperlinkButton:
<HyperlinkButton NavigateUri=\"/Project;component/MyPage.xaml\" Content=\"Navigate to my page\"/>27 сентября 2010, понедельник. Несмотря на то, что обычно понедельник считается днем тяжелым, более ста разработчиков собрались в офисе Microsoft для того, чтобы обсудить мобильную платформу Windows Phone 7. Это было первое мероприятие по Windows Phone 7 в России с подобным размахом. В нем приняли участие разработчики на различных платформах, представители таких компаний как Samsung и LG, а также просто много хороших людей. Но несомненно всех объединяло одно – огромный интерес к Windows Phone 7.
\nДля того, чтобы насладиться атмосферой мероприятия, мне пришлось проснуться немного пораньше, примерно через 8 часов я уже был в офисе в Крылатском, где меня сразу встретили Миша и Володя и вручили телефон на Windows Phone 7.
\nЧто отличало данное мероприятие от остальных – это пониженная степень официальности. На открытии мероприятия было объявлено, что главная цель – неформальное общение, и определены некоторые правила, главное из которых – не фотографировать то, что будет показываться.
\nНа самом деле настрой на неформальное общение был определен еще в процессе подготовки мероприятия, когда буквально за час до мероприятия мы вносили некоторые корректировки в выступления и демонстрации. Это, на мой взгляд, придало демонстрациям больше естественности. Например, большинство своих демонстраций я так и не успел проделать до мероприятия, но у меня был в голове сценарий – поэтому почти весь код пришлось писать прямо в процессе доклада. Мне такая практика очень понравилась – ощущается доверие аудитории.
\nОткрыл мероприятие Михаил Черномордиков с обзором платформы Windows Phone 7. Доклад был короткий, но имел важное значение – он определил настрой на весь оставшийся день. Миша рассказал, что некоторые моменты Windows Phone 7 до сих пор нельзя показывать широкой аудитории (отсюда и ограничение на фотографирование). Несмотря на это, российский офис Microsoft пошел на то, чтобы использовать в демонстрациях устройство, а не эмулятор.
\nПосле вступительного доклада я рассказывал про разработку мобильных приложений на платформе Silverlight. Несмотря на то, что было запланировано огромное количество демонстраций, показать большую их часть просто не хватило времени. Я постарался подробно рассказать про базовые принципы разработки мобильных приложений, сделал несколько демонстраций по созданию мобильного клиента для магазина Softkey и привязал текущее местоположение к карте Bing Maps, которая управлялась акселерометром. Насколько удался доклад судить, конечно, не мне и я очень рад буду услышать ваши комментарии к нему (если можно – в почту). На самом деле, тот момент, что я не успел показать все демонстрации не такой уж и плохой – будет о чем поговорить на Платформе.
\nФотографий с первых двух докладов у меня нет, поскольку в это время я готовился к своему докладу и, собственно, делал сам доклад. Далее описание сопровождается фотографиями.
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/f39df0e0/1@2x.jpg\")
\n\n\n\n\nСледуя плотному графику сразу же после меня, без перерывов Дмитрий Сошников начал рассказывать про разработку игр для мобильной платформы на основе XNA. Что особенно приятно, Дима поддержал заданный настрой и показывал больше практических вещей, а не слайдов. В докладе он рассказал о том, как разрабатывал так популярную в 90-ые годы игру “Морской бой”.
\nВ процессе докладов для докладчиков была одна неприятная неожиданность — микрофон нужно было держать в руках. Каждый докладчик по-своему пытался решать эту проблему: я, например, улучшал свои умения в написании программ одной рукой, Володя Колесников для этого дела приспособил карман рубашки. Дима, на мой взгляд, решил эту проблему креативнее всех.
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/beaa8d22/2@2x.jpg\")
\n\n\n\n\nПо плану после доклада про XNA был обед. Но доклад настолько заинтересовал аудиторию, что никто не спешил уходить на обед, а Диму засыпали огромным количеством вопросов про разработку игр. Представляете себе, что такое удержать больше сотни голодных разработчиков в аудитории перед обедом? Диме это удалось.
\nКстати говоря, участники мероприятия удалились на обед ненадолго. Буквально через несколько минут можно было наблюдать картину, где Мишу атаковала толпа разработчиков – у него было устройство Windows Phone 7!
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/f2ae8b74/3@2x.jpg\")
\n\n\n\n\nПосле обеда эстафетную палочку докладчиков подхватил Костя Кичинский. Он рассказывал про дизайн приложений Windows Phone 7 и о философии пользовательского интерфейса в новой мобильной платформе.
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/f2aacdd6/4@2x.jpg\")
\n\n\n\n\nНа мой взгляд, такой доклад делать одновременно и тяжело и легко – есть как явные сторонники стиля Metro (используемого в Windows Phone 7), так и явные противники. К сожалению, так получилось, что я пропустил почти весь доклад. Однако, судя по отзывам других участников доклад удался.
\nПосле этих докладов участников ждали рассказы от Spb Software и ГАЛС-Софт про их опыт разработки для Windows Phone 7.
\nПервым взял слово Хитров Денис из Spb Software. Денис – отличный и приветливый докладчик. В начале доклада он трижды поздоровался с аудиторией (а значит, пожелал здоровья). Он рассказал про плюсы и минусы (которых не так много) мобильной платформы, показал прототипы продукты Spb Soft для Windows Phone 7.
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/52ecdaae/5@2x.jpg\")
\n\n\n\n\nКстати говоря, во время демонстраций Дениса из окна просочился яркий солнечный свет: это знак свыше – на новую мобильную платформу наконец-то пролился свет в таком большом количестве! :)
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/3cf919fa/6@2x.jpg\")
\n\n\n\n\nПосле выступления Дениса, Алексей Петровских, представитель ГАЛС-Софт рассказал про их опыт и успехи. Он раскрыл секреты того, когда нужно использовать Silverlight и XNA, а также показал свои наработки в этой области.
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/476c9261/7@2x.jpg\")
\n\n\n\n\nПосле выступления Алексея был небольшой перерыв и огромное количество общения в кулуарах. К сожалению, это общение пришлось прервать, поскольку дальше всех ожидала практическая часть мероприятия от Володи Колесникова. В ней каждый разработчик на своих ноутбуках мог попробовать по шагам сделать свое приложение для Windows Phone 7, а особо интересующиеся – запустить его на реальном устройстве.
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/1762fe4e/8@2x.jpg\")
\n\n\n\n\nВ завершении мероприятия Михаил Черномордиков сделал доклад про Windows Marketplace. Начался он со слов “Поговорим про деньги?”. Какой человек бы не заинтересовался бы после этого?
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/d39ae510/9@2x.jpg\")
\n\n\n\n\nНа самом деле Миша рассказал много полезной информации о нюансах получения прибыли через Windows Marketplace. Как и ожидалось этот доклад вызвал множество вопросов и бурную дискуссию, которая плавно переросла в фуршет.
\nМножество людей спрашивали меня про устройство. Да, действительно пообщаться с устройством мне удалось гораздо больше других. Стоит отметить, что те устройства, которые доступны сейчас – это только прототипы, которые никогда не появятся на рынке. Поэтому оценивать эргономику корпуса, качество сборки или камеры смысла нет. Однако, что можно сказать совершенно точно – он действительно быстрый, а пользовательский интерфейс в нем приятный и отзывчивый. Работа с устройством доставляет огромное удовольствие и никакого дискомфорта.
\nЕстественно, фотографий устройства я не делал, исходя из ранее оглашенных правил.
\nДоклад про Windows Marketplace вызвал огромное количество вопросов, поэтому про них подробнее. Краткая выжимка доклада и сессии Q&A:
\nТ.е. выполнив несколько несложных действий по регистрации и заплатив небольшую сумму денег каждый российский разработчик получает возможность продавать свои мобильные приложения по всему миру!
\nПриятно удивил состав участников конференции. Поскольку мы пригласили на мероприятие разработчиков на совершенно разных платформах, то не исключен был сценарий холиваров. Этого не произошло. Участники, наоборот, были очень заинтересованы в конструктивной беседе и получении информации.
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/0daa1329/10@2x.jpg\")
\n\n\n\n\nОчень важно и показательно, что к мероприятию присоединились разработчики на других платформах. Очень много было людей с Mac Book и iPad. Были и разработчики для Android.
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/794356bb/11@2x.jpg\")
\n\n\n\n\nС многими мне удалось пообщаться на разные темы лично. В дискуссиях мы пришли к тому, что Windows Phone 7 хоть и молодая, но очень перспективная платформа, обладающая огромнейшим потенциалом на рынке.
\nНа мой взгляд в целом мероприятие прошло просто отлично – море общения, информации, обмена мнениями и, конечно же, устройства с Windows Phone 7. Именно так должны происходить фокусные технологические мероприятия.
\nНу и конечно нужно поблагодарить главных зачинщиков Windows Phone 7 Workshop – Мишу Черномордикова и Володю Колесникова. Они действительно приложили много усилий, чтобы всё получилось.
\n\n\n\n![\"Тренинг](\"https://blog.zwezdin.com/2010/wp7-training/b0a1dd19/12@2x.jpg\")
",
"tags": [
"Windows Phone",
"Мероприятия"
],
"banner_image": "https://blog.zwezdin.com/2010/wp7-training/de7aa137/wp7_training@cover.jpg"
},
{
"id": "https://blog.zwezdin.com/2010/silverlight-gac/",
"url": "https://blog.zwezdin.com/2010/silverlight-gac/",
"title": "Как добавить в GAC сборку Silverlight",
"date_published": "2010-06-27T12:00:00.000Z",
"content_html": "Недавно я озадачился вопросом добавления сборки Silverlight в GAC. Это необходимо для того, чтобы можно было сослаться на сборку из нескольких проектов и не переносить эту сборку каждый раз с проектом.
\nКак известно – среда исполнения Silverlight – это не то же самое, что среда исполнения .NET Framework и простое добавление сборки в глобальное хранилище при помощи gacutil не дает никакого эффекта. Но с другой стороны, после установки Silverlight мы можем видеть в списке доступных сборок диалога Add reference в Visual Studio набор стандартных сборок, входящих в состав Sliverlight.
Как оказалось, для того, чтобы дать возможность ссылаться на сборку из любых проектов через диалог Add reference, нужно добавить специальный ключ в реестр:
HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node\\Microsoft\\Microsoft SDKs\\Silverlight\\v4.0\\AssemblyFoldersEx. Если у вас 32-битная ОС, то составляющую Wow6432Node нужно исключить.![\"Как](\"https://blog.zwezdin.com/2010/silverlight-gac/77f0870a/1@2x.png\")
\n\n\n\n\nТеперь при добавлении ссылки в проект, в диалоге Add reference будут доступны все сборки из указанной папки.
![\"Как](\"https://blog.zwezdin.com/2010/silverlight-gac/eedff277/2@2x.png\")
\n\n\n\n\nРешение проблемы очень не сложное, но в нужный момент, бывает, его найти очень не просто. Успехов вам!
", "tags": [ "XAML", "Silverlight" ], "banner_image": "https://blog.zwezdin.com/2010/silverlight-gac/acb40b49/silverlight_gac@cover.png" }, { "id": "https://blog.zwezdin.com/2010/windows-phone-tasks/", "url": "https://blog.zwezdin.com/2010/windows-phone-tasks/", "title": "Использование стандартных диалогов в Windows Phone 7", "date_published": "2010-06-03T12:00:00.000Z", "content_html": "Любое мобильное устройство обладает стандартной функциональностью, которая специфична для конкретной платформы. Если говорить, например, о мобильных устройствах на базе Windows Phone 7, то такая функциональность – это и запуск камеры, и звонок по телефону, и отправка электронной почты с помощью Outlook Mobile, и ряд других задач. Для того, чтобы приложения могли использовать эту функциональность существует стандартный API, которым могут воспользоваться разработчики. О нем здесь и пойдет речь.
\n\n\n\n![\"Использование](\"https://blog.zwezdin.com/2010/windows-phone-tasks/f64361d0/1@2x.png\")
\n\n\n\n\nВообще, стандартная функциональность операционной системы доступна приложению путем использования специальных объектов Tasks (задачи), которые входят в стандартный API. Идеология строится на том, чтобы для каждого сценария иметь свою задачу. Каждая задача представлена в виде стандартного объекта, реализующего интерфейс ITask или IChooser.
Интерфейс ITask очень прост и состоит из единственного метода для запуска задачи.
public interface ITask\n{\n void Show();\n}Как видно, задачи можно просто запускать, более никакой функциональности недоступно. В некоторых ситуациях этого недостаточно. Например, если мы запускаем камеру, то хотелось бы получить результат. Поэтому для таких задач появился интерфейс IChooser, который расширяет функциональность ITask.
public abstract class IChooser : ITask\n{\n protected IChooser();\n\n public EventArgs EventArgs { get; set; }\n\n public abstract void Deserialize(Stream s);\n public abstract void OnInvokeReturned(byte[] outputBuffer);\n public abstract void Serialize(Stream s);\n public abstract void Show();\n}Здесь одним из наиболее важных моментов является наличие свойства EventArgs, которое и будет содержать результат выполнения задачи. Особо внимательные читатели уже, наверное, заметили, что на самом деле IChooser – это вовсе никакой не интерфейс, IChooser — это абстрактный класс. Это необходимо для того, чтобы в нем можно было реализовать часть логики.
Все задачи в Windows Phone 7 (за маленьким исключением) реализуют тот или иной интерфейс. Поэтому с большинством из них мы можем работать, абстрагируясь от конкретной задачи.
\nТеперь давайте посмотрим какие типы задач существуют на данный момент в Windows Phone 7 и каким образом их можно использовать. В первую очередь для того, чтобы использовать задачи, следует подключить стандартную сборку Microsoft.Phone.Tasks.
![\"Использование](\"https://blog.zwezdin.com/2010/windows-phone-tasks/30d1be89/2@2x.png\")
\n\n\n\n\nПосле подключения этой сборки становятся доступными объекты, выполняющие различные задачи в Windows Phone 7. Типы задач, доступные на момент написания этого материала (April 2010 CTP):
\nCameraCaptureTask – позволяет получить изображение с камеры;EmailAddressChooserTask – позволяет выбрать абонента из телефонной книги и получить его e-mail;EmailComposeTask – запускает задачу написания e-mail сообщения;MarketplaceLauncher – запускает приложение для Marketplace;MediaPlayerLauncher – запускает проигрыватель медиа-файлов;PhoneCallTask – запускает приложения набора номера телефона;PhoneNumberChooserTask – позволяет выбрать абонента из телефонной книги и получить его номер телефона;PhotoChooserTask – позволяет выбрать фото из существующей коллекции изображений или с камеры;SaveEmailAddressTask – позволяет сохранить адрес электронной почты в телефонной книге;SavePhoneNumberTask – позволяет сохранить номер телефона в телефонной книге;SearchTask – запускает системное окно поиска;SmsComposeTask – запускает задачу написания сообщения SMS;WebBrowserTask – запускает веб-браузер.После запуска задачи и ее выполнения в некоторых случаях требуется обработать результаты выполнения задачи. Для этого можно воспользоваться двумя способами – обратиться к экземпляру класса той задачи, которую запустил пользователь и использовать свойство EventArgs, либо использовать объект ChooserListener и подписаться на событие ChooserCompleted для обработки результата. Оба подхода по большей степени равноценны, и какой из них выбрать – дело конкретного случая. Использование объекта ChooserListener сводится к следующему коду.
public MainPage()\n{\n InitializeComponent();\n\n SupportedOrientations = SupportedPageOrientation.Portrait | SupportedPageOrientation.Landscape;\n\n ChooserListener.ChooserCompleted += new EventHandler(ChooserListener_ChooserCompleted);\n}\n\nvoid ChooserListener_ChooserCompleted(object sender, EventArgs e)\n{\n var data = (TaskEventArgs<PhotoResult>)e;\n\n var photoStream = data.Result.ChosenPhoto;\n\n // обработка изображения\n}Теперь, когда основные принципы работы с задачами в Windows Phone 7 стали более понятны, давайте рассмотрим небольшой пример, как мы по шагам можем вызывать задачи, а также получим изображение с камеры (в случае эмулятора – виртуальной камеры).
\nСоздадим новый проект Windows Phone 7 и сделаем ссылку на сборку Microsoft.Phone.Tasks.В нашем приложении мы будем использовать меню для вызова разных типов задач, поэтому сделаем также ссылку на сборку Microsoft.Phone.Shell. Добавим пространство имен для Microsoft.Phone.Shell в разметку формы и создадим объект ApplicationBar.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"LauncherTest.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n <phoneNavigation:PhoneApplicationPage.ApplicationBar>\n <shell:ApplicationBar IsMenuEnabled=\"True\">\n <shell:ApplicationBar.MenuItems>\n </shell:ApplicationBar.MenuItems>\n </shell:ApplicationBar>\n </phoneNavigation:PhoneApplicationPage.ApplicationBar>\n\n <Grid x:Name=\"LayoutRoot\" Background=\"{StaticResource PhoneBackgroundBrush}\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\" Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"page title\" x:Name=\"textBlockListTitle\" Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n <Image Height=\"171\" HorizontalAlignment=\"Left\" Margin=\"179,347,0,0\" Name=\"image1\" Stretch=\"Fill\" VerticalAlignment=\"Top\" Width=\"170\" />\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>Несмотря на то, что основной сценарий в данном приложении – использование мобильной камеры, мы также оставим возможно запускать другие типы задач. Поэтому добавим в меню несколько пунктов для каждого из типов задач.
\n<phoneNavigation:PhoneApplicationPage\n x:Class=\"LauncherTest.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n <phoneNavigation:PhoneApplicationPage.ApplicationBar>\n <shell:ApplicationBar IsMenuEnabled=\"True\">\n <shell:ApplicationBar.MenuItems>\n <shell:ApplicationBarMenuItem Text=\"Camera\" Click=\"CameraMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Email address\" Click=\"EmailAddressMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Email message\" Click=\"EmailMessageMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Marketplace\" Click=\"MarketPlaceMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Media player\" Click=\"MediaPlayerMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Phone call\" Click=\"PhoneCallMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Phone number\" Click=\"PhoneNumberMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Choose photo\" Click=\"ChoosePhotoMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Save email\" Click=\"SaveEmailMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Save phone number\" Click=\"SavePhoneNumberMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Search\" Click=\"SearchMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Compse SMS\" Click=\"ComposeSMSMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Web\" Click=\"WebMenuItem_Click\"/>\n </shell:ApplicationBar.MenuItems>\n </shell:ApplicationBar>\n </phoneNavigation:PhoneApplicationPage.ApplicationBar>\n\n <Grid x:Name=\"LayoutRoot\" Background=\"{StaticResource PhoneBackgroundBrush}\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\" Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"page title\" x:Name=\"textBlockListTitle\" Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n <Image Height=\"171\" HorizontalAlignment=\"Left\" Margin=\"179,347,0,0\" Name=\"image1\" Stretch=\"Fill\" VerticalAlignment=\"Top\" Width=\"170\" />\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>Обработчик для каждого из пунктов меню будет иметь достаточно простой вид – он будет создавать соответствующий тип задачи и запускать его.
\nusing System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Net;\nusing System.Windows;\nusing System.Windows.Controls;\nusing System.Windows.Documents;\nusing System.Windows.Input;\nusing System.Windows.Media;\nusing System.Windows.Media.Animation;\nusing System.Windows.Shapes;\nusing Microsoft.Phone.Controls;\nusing Microsoft.Phone.Tasks;\nusing System.Windows.Media.Imaging;\n\nnamespace LauncherTest\n{\n public partial class MainPage : PhoneApplicationPage\n {\n private CameraCaptureTask _task = new CameraCaptureTask();\n public MainPage()\n {\n InitializeComponent();\n\n SupportedOrientations = SupportedPageOrientation.Portrait | SupportedPageOrientation.Landscape;\n }\n\n private void CameraMenuItem_Click(object sender, EventArgs e)\n {\n (new CameraCaptureTask()).Show();\n }\n\n private void EmailAddressMenuItem_Click(object sender, EventArgs e)\n {\n (new EmailAddressChooserTask()).Show();\n }\n\n private void EmailMessageMenuItem_Click(object sender, EventArgs e)\n {\n (new EmailComposeTask()).Show();\n }\n\n private void MarketPlaceMenuItem_Click(object sender, EventArgs e)\n {\n MarketplaceLauncher.Show(MarketplaceContent.Applications, MarketplaceOperation.Open);\n }\n\n private void MediaPlayerMenuItem_Click(object sender, EventArgs e)\n {\n (new MediaPlayerLauncher()).Show();\n }\n\n private void PhoneCallMenuItem_Click(object sender, EventArgs e)\n {\n (new PhoneCallTask()).Show();\n }\n\n private void PhoneNumberMenuItem_Click(object sender, EventArgs e)\n {\n (new PhoneNumberChooserTask()).Show();\n }\n\n private void ChoosePhotoMenuItem_Click(object sender, EventArgs e)\n {\n (new PhotoChooserTask()).Show();\n }\n\n private void SaveEmailMenuItem_Click(object sender, EventArgs e)\n {\n (new SaveEmailAddressTask()).Show();\n }\n\n private void SavePhoneNumberMenuItem_Click(object sender, EventArgs e)\n {\n (new SavePhoneNumberTask()).Show();\n }\n\n private void SearchMenuItem_Click(object sender, EventArgs e)\n {\n (new SearchTask()).Show();\n }\n\n private void ComposeSMSMenuItem_Click(object sender, EventArgs e)\n {\n (new SmsComposeTask()).Show();\n }\n\n private void WebMenuItem_Click(object sender, EventArgs e)\n {\n (new WebBrowserTask()).Show();\n }\n }\n}Теперь, запустив приложение и выбрав какую-то из задач, можно убедиться, что они запускаются. Например, запустим задачу выбора изображений.
\n\n\n\n![\"Использование](\"https://blog.zwezdin.com/2010/windows-phone-tasks/3496ed70/3@2x.png\")
\n\n\n\n\nТеперь осталось задать обработчик результата. Воспользуемся для этого объектом ChooserListener, и будем обрабатывать получение изображения от камеры. После выполнения задачи просто отобразим изображение на форме.
public MainPage()\n{\n InitializeComponent();\n\n SupportedOrientations = SupportedPageOrientation.Portrait | SupportedPageOrientation.Landscape;\n\n ChooserListener.ChooserCompleted += new EventHandler(ChooserListener_ChooserCompleted);\n}\n\nvoid ChooserListener_ChooserCompleted(object sender, EventArgs e)\n{\n if (e is TaskEventArgs<PhotoResult>)\n {\n var taskEventArgs = (TaskEventArgs<PhotoResult>)e;\n var photoStream = taskEventArgs.Result.ChosenPhoto;\n\n var bitmapImage = new BitmapImage();\n bitmapImage.SetSource(photoStream);\n\n image1.Source = bitmapImage;\n }\n}Событие ChooserCompleted вызывается после завершения каждой задачи. Однако, в каждом случае тип аргумента будет разным. Например, для задачи CameraCaptureTask аргумент будет иметь тип TaskEventArgs<PhotoResult>. Поскольку камера отсутствует в эмуляторе, то вместо реального изображения там будут сгенерирована случайная картинка.
![\"Использование](\"https://blog.zwezdin.com/2010/windows-phone-tasks/ff14c9ab/4@2x.png\")
\n\n\n\n\nТаким образом, мы с вами имеем готовый API для того, чтобы выполнить ряд стандартных для мобильного устройства задач.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-phone-tasks/510c5d98/windows_phone-tasks@cover.jpg" }, { "id": "https://blog.zwezdin.com/2010/silverlight-simple-behaviors/", "url": "https://blog.zwezdin.com/2010/silverlight-simple-behaviors/", "title": "Простые поведения в Silverlight", "date_published": "2010-06-01T12:00:00.000Z", "content_html": "Анимации и различного рода трансформации – это основа интерактивности любого современного пользовательского интерфейса. В WPF и Silverlight для этих целей есть набор объектов для анимацией и трансформаций. Для инициации того или иного действия используются события или триггеры. В конечном счете создание множества триггеров существенно снижает читаемость кода, а также его повторное использование. VisualStateManager позволяет отчасти решить эту проблему. Однако, есть еще более элегантный способ – использование поведений (Behavior).
\nСразу оговорюсь, что здесь я буду говорить о Silverlight в целом. Аналогичные механизмы доступны для веб-приложений на базе Silverlight, для настольных приложений на базе Silverlight и для мобильных приложений на базе Silverlight. Кроме того, аналогичный подход можно использовать и в WPF-приложениях. Поэтому я не буду конкретизировать платформу, ну а где конкретно применять эти механизмы – решать вам.
\nИтак, что же такое поведения? Поведения (behaviors) – это специальные объекты, которые позволяют добавлять функционал в приложения, не написав ни одной строчки кода (изменив только разметку). Каждое поведение реализует небольшой функционал, например анимацию “дрожания” или “размытия”.
\nПростые поведения являются объектами, унаследованными от класса Behavior<T>. При реализации своего поведения есть возможность обработать момент подключения и отключения поведения. Каждый элемент Behavior может быть подключен к любому визуальному элементу. Давайте попробуем создать простое поведение и подключить его.
Для начала подключим сборку System.Windows.Interactivity. После этого нужно создать класс-наследник Behavior<T>, где параметр T – это тип элемента управления, к которому можно применить данное поведение. В качестве этого параметра можно указать объект UIElement — тогда это поведение можно будет использовать с любыми элементами управления. Класс Behavior<T> содержит два виртуальных метода – OnAttached и OnDetaching. Эти методы вызываются при подключении или отключении поведения. Чтобы обработать эти события можно переопределить эти методы и определить в них свою логику.
public class SimpleBehavior1 : Behavior<UIElement>\n{\n protected override void OnAttached()\n {\n base.OnAttached();\n }\n\n protected override void OnDetaching()\n {\n base.OnDetaching();\n }\n}Для того, чтобы работать с текущим элементом управления (к которому это поведение присоединено) можно использовать свойство AssociatedObject. Логика поведения обычно определяется в событиях, на которые можно подписаться в момент подключения поведения. Давайте создадим эффект размытия для текущего элемента в момент наведения указателя мыши. Для этого будем инициализировать свойство Effect текущего элемента управления объектом BlurEffect в момент наведения и очищать его, когда указатель находится вне этого элемента управления. Получим несложное определение поведения.
public class SimpleBehavior1 : Behavior<UIElement>\n{\n protected override void OnAttached()\n {\n base.OnAttached();\n AssociatedObject.MouseEnter += AssociatedObject_MouseEnter;\n AssociatedObject.MouseLeave += AssociatedObject_MouseLeave;\n }\n\n protected override void OnDetaching()\n {\n AssociatedObject.MouseEnter -= AssociatedObject_MouseEnter;\n AssociatedObject.MouseLeave -= AssociatedObject_MouseLeave;\n base.OnDetaching();\n }\n\n void AssociatedObject_MouseEnter(object sender, MouseEventArgs e)\n {\n AssociatedObject.Effect = new BlurEffect() { Radius = 5 };\n }\n\n void AssociatedObject_MouseLeave(object sender, MouseEventArgs e)\n {\n AssociatedObject.Effect = null;\n }\n}Для того, чтобы применить это поведение, в разметке следует подключить пространство имен System.Windows.Interactivity и пространство имен с определением поведения.
xmlns:b=\"clr-namespace:Behavior1\"\nxmlns:interactivity=\"clr-namespace:System.Windows.Interactivity;assembly=System.Windows.Interactivity\"Добавим теперь кнопку на пустую форму и применим к нему это поведение. Получим следующую разметку.
\n<UserControl x:Class=\"Behavior1.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:b=\"clr-namespace:Behavior1\"\n xmlns:interactivity=\"clr-namespace:System.Windows.Interactivity;assembly=System.Windows.Interactivity\"\n mc:Ignorable=\"d\"\n d:DesignHeight=\"300\" d:DesignWidth=\"400\">\n\n <Grid x:Name=\"LayoutRoot\" Background=\"White\">\n <Button Margin=\"50\" Content=\"Счастье\" Width=\"200\" Height=\"150\">\n <interactivity:Interaction.Behaviors>\n <b:SimpleBehavior1 />\n </interactivity:Interaction.Behaviors>\n </Button>\n </Grid>\n</UserControl>Запустим приложение и увидим, что при наведении указателя мыши на кнопку она становится размытой.
\n\n\n\n![\"Простые](\"https://blog.zwezdin.com/2010/silverlight-simple-behaviors/ac8fed42/1@2x.png\")
\n\n\n\n\nПриведенный выше пример очень простой. Давайте усложним пример и сделаем размытие анимированным. Для этого я создам два объекта Storyboard (для появления и исчезновения размытия) и буду запускать эти анимации при возникновении тех же событий.
public class SimpleBehavior2 : Behavior<UIElement>\n{\n private readonly BlurEffect _effect = new BlurEffect() {Radius = 0};\n\n private readonly Storyboard _showStoryboard = new Storyboard();\n private readonly Storyboard _hideStoryboard = new Storyboard();\n\n protected override void OnAttached()\n {\n base.OnAttached();\n AssociatedObject.MouseEnter += AssociatedObject_MouseEnter;\n AssociatedObject.MouseLeave += AssociatedObject_MouseLeave;\n AssociatedObject.Effect = _effect;\n\n\n var showAnimation = new DoubleAnimation\n {\n To = 100\n };\n\n Storyboard.SetTarget(showAnimation, _effect);\n Storyboard.SetTargetProperty(showAnimation, new PropertyPath(BlurEffect.RadiusProperty));\n showAnimation.Duration = new Duration(TimeSpan.FromMilliseconds(900));\n _showStoryboard.Children.Add(showAnimation);\n\n\n var hideAnimation = new DoubleAnimation\n {\n To = 0,\n };\n Storyboard.SetTarget(hideAnimation, _effect);\n Storyboard.SetTargetProperty(hideAnimation, new PropertyPath(BlurEffect.RadiusProperty));\n hideAnimation.Duration = new Duration(TimeSpan.FromMilliseconds(200));\n\n _hideStoryboard.Children.Add(hideAnimation);\n }\n\n protected override void OnDetaching()\n {\n AssociatedObject.MouseEnter -= AssociatedObject_MouseEnter;\n AssociatedObject.MouseLeave -= AssociatedObject_MouseLeave;\n AssociatedObject.Effect = null;\n base.OnDetaching();\n }\n\n\n void AssociatedObject_MouseEnter(object sender, MouseEventArgs e)\n {\n _showStoryboard.Begin();\n }\n\n void AssociatedObject_MouseLeave(object sender, MouseEventArgs e)\n {\n _hideStoryboard.Begin();\n }\n}Аналогичным образом определим данное поведение в разметке и запустим пример. Теперь размытие появляется плавно. Я не буду делать здесь снимки экрана, поскольку анимацию будет показать очень сложно – запустите пример, чтобы увидеть самим.
\nДавайте еще немного усложним пример и попробуем добавить трансформации к объекту. Как известно, для того, чтобы трансформировать объект нужно использовать свойство RenderTransform. Если используется несколько трансформаций, то это свойство необходимо инициализировать объектом TransformGroup, в который поместить все нужные трансформации.
Поскольку мы незнаем заранее применяются ли уже к объекту трансформации мы должны рассмотреть все варианты и написать несложный код по добавлению своей трансформации к объекту в момент присоединения поведения.
\nif (AssociatedObject.RenderTransform == null)\n{\n AssociatedObject.RenderTransform = _transofrmation;\n}\nelse if (AssociatedObject.RenderTransform is TransformGroup)\n{\n ((TransformGroup)AssociatedObject.RenderTransform).Children.Add(_transofrmation);\n}\nelse\n{\n var transformGroup = new TransformGroup();\n var sourceTransform = AssociatedObject.RenderTransform;\n transformGroup.Children.Add(sourceTransform);\n transformGroup.Children.Add(_transofrmation);\n\n AssociatedObject.RenderTransform = transformGroup;\n}Остальное – аналогично тому, как мы это делали в предыдущих примерах – определяем анимации и подписываемся на события. Итого получим несложное поведение, реагирующее также на наведения указателя мыши.
\npublic class SimpleBehavior3 : Behavior<UIElement>\n{\n private readonly SkewTransform _transofrmation = new SkewTransform();\n private readonly Storyboard _showStoryboard = new Storyboard();\n\n protected override void OnAttached()\n {\n base.OnAttached();\n\n if (AssociatedObject.RenderTransform == null)\n {\n AssociatedObject.RenderTransform = _transofrmation;\n }\n else if (AssociatedObject.RenderTransform is TransformGroup)\n {\n ((TransformGroup)AssociatedObject.RenderTransform).Children.Add(_transofrmation);\n }\n else\n {\n var transformGroup = new TransformGroup();\n var sourceTransform = AssociatedObject.RenderTransform;\n transformGroup.Children.Add(sourceTransform);\n transformGroup.Children.Add(_transofrmation);\n\n AssociatedObject.RenderTransform = transformGroup;\n }\n\n AssociatedObject.MouseEnter += AssociatedObject_MouseEnter;\n\n\n\n var animation = new DoubleAnimationUsingKeyFrames();\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.Zero), Value = 0 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(100)), Value = 20 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(300)), Value = -20 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(500)), Value = 10 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(700)), Value = -10 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(900)), Value = 0 });\n\n\n Storyboard.SetTarget(animation, _transofrmation);\n Storyboard.SetTargetProperty(animation, new PropertyPath(SkewTransform.AngleXProperty));\n _showStoryboard.Children.Add(animation);\n }\n\n protected override void OnDetaching()\n {\n AssociatedObject.MouseEnter -= AssociatedObject_MouseEnter;\n base.OnDetaching();\n }\n\n void AssociatedObject_MouseEnter(object sender, MouseEventArgs e)\n {\n _showStoryboard.Begin();\n }\n}Запустим приложение и увидим анимированный объект при наведении указателя мыши.
\n\n\n\n![\"Простые](\"https://blog.zwezdin.com/2010/silverlight-simple-behaviors/beeccec0/2@2x.png\")
\n\n\n\n\nЧто интересно, мы можем применить одновременно несколько поведений к одному объекту. Например, можем применить размытие и трансформацию одновременно. Для этого используем следующую разметку.
\n<Button Margin=\"50\" Content=\"Счастье\" Width=\"200\" Height=\"150\">\n <interactivity:Interaction.Behaviors>\n <b:SimpleBehavior2 />\n <b:SimpleBehavior3 />\n </interactivity:Interaction.Behaviors>\n</Button>Недавно я рассказывал об использовании поведений в Silverlight. Мы рассматривали возможности объекта Behavior<T>, позволяющего определить визуальное поведение объекта. Вся логика этого объекта была полностью определена внутри реализации поведения. При этом, если нужно было поменять условие срабатывания того или иного действия, то необходимо было изменить код поведения, что несомненно является большим недостатком такого вида поведений. В этой статье мы рассмотрим другой тип поведений, которые позволяют избежать этого.
Основной проблемой простых поведений, реализованных на базе Behavior<T> является то, что внутри реализации мы жестко задаем набор событий, с которыми будем работать. Это может быть не всегда удобным. Например, если у нас есть поведение для размытия объекта, то было бы удобно в некоторых ситуациях применять поведение при наведении указателя мыши, а в некоторых – при нажатии на кнопку.
Для того, чтобы реализовать такое поведение можно воспользоваться другим типом поведений, реагирующих на заданные события. Такие поведения создаются на базе объекта TriggerAction<T> и позволяют реализовать собственное поведение.
Для создания собственного поведения создадим класс-наследник TriggerAction<T>. В отличие от простых поведений, поведения TriggerAction<T> имеют дополнительный метод Invoke, который срабатывает при наступлении заданного события. Кроме того, в поведениях TriggerAction<T> есть также два перегружаемых метода OnAttached и OnDetaching, позволяющих выполнить предварительные и заключительные действия. Давайте сравним порядок действий, выполняемых для простых поведений и для поведений на основе TriggerAction<T>.
Простые поведения, реализованные на основе объекта Behavior<T>:
Behavior<T>;OnAttached задаем необходимые базовые трансформации, если они необходимы;OnAttached подписываемся на нужные события, которые будут обрабатываться поведением;Поведения, реализованные на основе объекта TriggerAction<T>:
TriggerAction<T>;OnAttached задаем необходимые базовые трансформации, если они необходимы;Как видно, разница заключается в том, что простые поведения сами подписываются на нужные события в момент выполнения метода OnAttached, а поведения на базе TriggerAction<T> позволяют выбрать события в момент подключения поведения к элементу управления. В этом и состоит разница между этими двумя поведениями.
TriggerAction<T>Для начала необходимо создать объект-наследник TriggerAction<T>. В качестве generic-параметра будем использовать объект UIElement – это позволит применить поведение к любому элементу управления. С другой стороны, если необходимы какие-то специфичные свойства конкретных элементов управления, то можно использовать более конкретный тип, например, Button, TextBox и т.д.
При создании поведения нужно реализовать единственный метод Invoke.
using System;\nusing System.Net;\nusing System.Windows;\nusing System.Windows.Controls;\nusing System.Windows.Documents;\nusing System.Windows.Ink;\nusing System.Windows.Input;\nusing System.Windows.Media;\nusing System.Windows.Media.Animation;\nusing System.Windows.Media.Effects;\nusing System.Windows.Shapes;\nusing System.Windows.Interactivity;\n\nnamespace SilverlightApplication30\n{\n public class EventSampleBehavior : TriggerAction<UIElement>\n {\n protected override void Invoke(object parameter)\n {\n\n }\n }\n}Если необходимо отследить момент подключения/отключения поведения от элемента управления, то можно перегрузить виртуальные методы OnAttaching и OnDeattaching.
using System;\nusing System.Net;\nusing System.Windows;\nusing System.Windows.Controls;\nusing System.Windows.Documents;\nusing System.Windows.Ink;\nusing System.Windows.Input;\nusing System.Windows.Media;\nusing System.Windows.Media.Animation;\nusing System.Windows.Media.Effects;\nusing System.Windows.Shapes;\nusing System.Windows.Interactivity;\n\nnamespace SilverlightApplication30\n{\n public class EventSampleBehavior : TriggerAction<UIElement>\n {\n protected override void OnAttached()\n {\n base.OnAttached();\n }\n\n protected override void OnDetaching()\n {\n base.OnDetaching();\n }\n\n protected override void Invoke(object parameter)\n {\n }\n }\n}Давайте определим логику, которая при срабатывании поведения будет трансформировать объект в виде небольшой анимации. Для этого добавим объекты трансформации и анимации в состав класса поведения. Также нам необходимо задать логику для определения трансформаций – если трансформации уже есть, то объединить их в группу, а если нет, то просто создать новую. Наконец, нам нужно задать поведение анимации. В данном случае воспользуемся анимацией DoubleAnimationUsingKeyFrames. Все эти действия следует выполнить в момент подключения поведения.
using System;\nusing System.Net;\nusing System.Windows;\nusing System.Windows.Controls;\nusing System.Windows.Documents;\nusing System.Windows.Ink;\nusing System.Windows.Input;\nusing System.Windows.Media;\nusing System.Windows.Media.Animation;\nusing System.Windows.Media.Effects;\nusing System.Windows.Shapes;\nusing System.Windows.Interactivity;\n\nnamespace SilverlightApplication30\n{\n public class EventSampleBehavior : TriggerAction<UIElement>\n {\n private readonly SkewTransform _transofrmation = new SkewTransform();\n private readonly Storyboard _showStoryboard = new Storyboard();\n\n protected override void OnAttached()\n {\n base.OnAttached();\n\n if (AssociatedObject.RenderTransform == null)\n {\n AssociatedObject.RenderTransform = _transofrmation;\n }\n else if (AssociatedObject.RenderTransform is TransformGroup)\n {\n ((TransformGroup)AssociatedObject.RenderTransform).Children.Add(_transofrmation);\n }\n else\n {\n var transformGroup = new TransformGroup();\n var sourceTransform = AssociatedObject.RenderTransform;\n transformGroup.Children.Add(sourceTransform);\n transformGroup.Children.Add(_transofrmation);\n\n AssociatedObject.RenderTransform = transformGroup;\n }\n\n\n var animation = new DoubleAnimationUsingKeyFrames();\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.Zero), Value = 0 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(100)), Value = 20 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(300)), Value = -20 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(500)), Value = 10 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(700)), Value = -10 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(900)), Value = 0 });\n\n Storyboard.SetTarget(animation, _transofrmation);\n Storyboard.SetTargetProperty(animation, new PropertyPath(SkewTransform.AngleXProperty));\n _showStoryboard.Children.Add(animation);\n }\n\n protected override void OnDetaching()\n {\n base.OnDetaching();\n }\n\n protected override void Invoke(object parameter)\n {\n }\n }\n}Все, что теперь осталось сделать, это запустить анимацию в момент вызова метода Invoke. В итоге получим следующий финальный код поведения.
using System;\nusing System.Net;\nusing System.Windows;\nusing System.Windows.Controls;\nusing System.Windows.Documents;\nusing System.Windows.Ink;\nusing System.Windows.Input;\nusing System.Windows.Media;\nusing System.Windows.Media.Animation;\nusing System.Windows.Media.Effects;\nusing System.Windows.Shapes;\nusing System.Windows.Interactivity;\n\nnamespace SilverlightApplication30\n{\n public class EventSampleBehavior : TriggerAction<UIElement>\n {\n private readonly SkewTransform _transofrmation = new SkewTransform();\n private readonly Storyboard _showStoryboard = new Storyboard();\n\n protected override void OnAttached()\n {\n base.OnAttached();\n\n if (AssociatedObject.RenderTransform == null)\n {\n AssociatedObject.RenderTransform = _transofrmation;\n }\n else if (AssociatedObject.RenderTransform is TransformGroup)\n {\n ((TransformGroup)AssociatedObject.RenderTransform).Children.Add(_transofrmation);\n }\n else\n {\n var transformGroup = new TransformGroup();\n var sourceTransform = AssociatedObject.RenderTransform;\n transformGroup.Children.Add(sourceTransform);\n transformGroup.Children.Add(_transofrmation);\n\n AssociatedObject.RenderTransform = transformGroup;\n }\n\n\n var animation = new DoubleAnimationUsingKeyFrames();\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.Zero), Value = 0 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(100)), Value = 20 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(300)), Value = -20 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(500)), Value = 10 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(700)), Value = -10 });\n animation.KeyFrames.Add(new SplineDoubleKeyFrame { KeyTime = KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(900)), Value = 0 });\n\n Storyboard.SetTarget(animation, _transofrmation);\n Storyboard.SetTargetProperty(animation, new PropertyPath(SkewTransform.AngleXProperty));\n _showStoryboard.Children.Add(animation);\n }\n\n protected override void OnDetaching()\n {\n base.OnDetaching();\n }\n\n protected override void Invoke(object parameter)\n {\n _showStoryboard.Begin();\n }\n }\n}Теперь, после создания поведения его необходимо подключить к элементу управления. Для этого необходимо подключить нужное пространство имен.
\nДобавим на форму кнопку и зададим для нее поведение.
\n<UserControl x:Class=\"SilverlightApplication30.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:i=\"clr-namespace:System.Windows.Interactivity;assembly=System.Windows.Interactivity\"\n xmlns:local=\"clr-namespace:SilverlightApplication30\"\n mc:Ignorable=\"d\"\n d:DesignHeight=\"300\" d:DesignWidth=\"400\">\n\n <Grid x:Name=\"LayoutRoot\" Background=\"White\">\n <Button Content=\"Button\" Width=\"400\" Height=\"300\" HorizontalAlignment=\"Center\" VerticalAlignment=\"Center\">\n <i:Interaction.Triggers>\n <i:EventTrigger EventName=\"MouseMove\">\n <local:EventSampleBehavior />\n </i:EventTrigger>\n </i:Interaction.Triggers>\n </Button>\n </Grid>\n</UserControl>Как видно, поведение будет срабатывать в момент запуска события MouseMove. При этом, если нам необходимо использовать поведение в других ситуациях, например, при нажатии на кнопке, то мы можем просто поменять имя события при присоединении его к элементу управления.
<UserControl x:Class=\"SilverlightApplication30.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:i=\"clr-namespace:System.Windows.Interactivity;assembly=System.Windows.Interactivity\"\n xmlns:local=\"clr-namespace:SilverlightApplication30\"\n mc:Ignorable=\"d\"\n d:DesignHeight=\"300\" d:DesignWidth=\"400\">\n\n <Grid x:Name=\"LayoutRoot\" Background=\"White\">\n <Button Content=\"Button\" Width=\"400\" Height=\"300\" HorizontalAlignment=\"Center\" VerticalAlignment=\"Center\">\n <i:Interaction.Triggers>\n <i:EventTrigger EventName=\"Click\">\n <local:EventSampleBehavior />\n </i:EventTrigger>\n </i:Interaction.Triggers>\n </Button>\n </Grid>\n</UserControl>Этим поведения на базе TriggerAction и являются более универсальными, чем простые поведения.
Пользовательский интерфейс Visual Studio 2010 построен на основе технологии Windows Presentation Foundation. Кроме эмоций (положительных и отрицательных) у этого явления есть еще и рациональное зерно – возможности для расширения различных частей Visual Studio. Поскольку в WPF пользовательский интерфейс описывается на основе языка XAML, то это дает возможность модифицировать его более просто. Одним из наиболее ярких примеров такого расширения функциональности – стартовые страницы Visual Studio 2010.
\nСтартовые страницы — это то, что мы видим сразу же после запуска Visual Studio. На них обычно собирается полезная для разработчика информация, такая как ссылки на ресурсы для разработчиков, новости, недавние проекты и др. Если взглянуть на то, как устроены стартовые страницы в Visual Studio 2010, то можно обнаружить, что это – не более, чем файл с разметкой XAML.
\n\n\n\n![\"Стартовая](\"https://blog.zwezdin.com/2010/visual-studio-2010-start-screen/4a5ac465/1@2x.png\")
\n\n\n\n\nИзменение содержимого стартовой страницы Visual Studio 2010 может быть полезным в самых различных ситуациях. Например, здесь можно подключить ленту корпоративного блога, для того, чтобы оперативно узнавать новости, происходящие внутри команды разработчиков. На самом деле сценарии здесь ограничиваются только фантазией разработчиков. Давайте рассмотрим процесс создания и модификации стартовых страниц.
\nЕсли вы устанавливали Visual Studio 2010 не изменяя стандартного пути, то содержимое стартовых страниц будет расположено в папке C:\\Program Files (x86)\\Microsoft Visual Studio 10.0\\Common7\\IDE\\StartPages\\. В предварительных версиях Visual Studio здесь находились XAML-файлы, которые поддавались модификации. В финальной сборке Visual Studio 2010 здесь находятся файлы, описывающие содержимое страниц, однако, это – не файлы XAML. Вообще говоря, не стоит изменять содержимое этих файлов, можно пойти более цивилизованным путем – использовать стандартные инструменты для модификации стартовых страниц.
Для создания стартовых страниц уже существует стандартный шаблон в Visual Studio Galery - Custom Start Page Project Template. При установке его в среду Visual Studio появляется новый тип проекта в разделе Extensibility → Custom Start Page.
![\"Стартовая](\"https://blog.zwezdin.com/2010/visual-studio-2010-start-screen/e1816ba5/2@2x.png\")
\n\n\n\n\nПреимуществом этого шаблона является то, что при создании проекта создаются шаблоны для встраивания, элементы управления WPF, а также шаблон VSIX, который позволяет быстро собрать модуль расширения для Visual Studio когда все будет готово.
\nДля отладки стартовой страницы можно просто запустить проект (F5). При этом запустится новый экземпляр Visual Studio 2010, который будет служить средой для просмотра результатов работы. Однако, по умолчанию новая стартовая страница отображаться не будет, для того, чтобы она отобразилась необходимо задать соответствующие параметры в Visual Studio. Для этих целей существует настройка Tools → Options → Environment → Startup → Customize Start Page. Здесь необходимо указать разрабатываемую страницу.
![\"Стартовая](\"https://blog.zwezdin.com/2010/visual-studio-2010-start-screen/02045ddd/3@2x.png\")
\n\n\n\n\nТеперь у нас готов проект для создания собственного представления стартовой страницы Visual Studio 2010.
\nРасширение состоит из двух проектов — главного проекта, в котором содержаться все необходимые элементы для установки страницы и вспомогательного проекта, содержащего элемент управления WPF.
\nГлавный проект содержит файл описания стартовой страницы StartPage.xaml, на которой размещается все содержимое стартовой страницы. По умолчанию на этой странице содержатся все стандартные вкладки, присутствующие в обычной стартовой странице Visual Studio 2010, и дополнительная вкладка с вашим содержимым. В дополнительной вкладке содержится элемент управления из вспомогательного проекта.
Также главный проект содержит манифест для создания пакета VSIX – файлы расширения Visual Studio 2010, которые можно установить в несколько нажатий мышью. Таким образом, при сборке приложения в папке с результатом сразу будет находится готовый VSIX-пакет, который можно устанавливать на другие рабочие места.
\nТеперь, когда мы разобрались со структурой проекта, давайте перейдем к формированию содержимого стартовой страницы.
\nДля управления содержимым стартовой страницы существует два варианта – изменение страницы StartPage.xaml в основном проекте и изменение элемента управления MyControl.xaml во вспомогательном проекте.
Если мы воспользуемся первым способом, то у нас будет больше возможностей по изменению внешнего вида страницы. Например, мы можем добавить логотип своей компании на стартовую страницу, изменить положение элементов Создать проект, Открыть проект или списка проектов, отрываемых недавно. Сценариев, которые мы можем выполнять, изменяя содержимое этого файла – огромное количество. Общая структура этого файла выглядит следующим образом.
<Grid xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:sp=\"clr-namespace:Microsoft.VisualStudio.PlatformUI;assembly=Microsoft.VisualStudio.Shell.StartPage\"\n xmlns:vs=\"clr-namespace:Microsoft.VisualStudio.PlatformUI;assembly=Microsoft.VisualStudio.Shell.10.0\"\n xmlns:vsfx=\"clr-namespace:Microsoft.VisualStudio.Shell;assembly=Microsoft.VisualStudio.Shell.10.0\"\n xmlns:my=\"clr-namespace:MyStartPageControl;assembly=MyStartPageControl\"\n mc:Ignorable=\"d\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\" d:DesignHeight=\"600\" d:DesignWidth=\"800\">\n\n <Grid.Resources>\n <ResourceDictionary>\n <ResourceDictionary.MergedDictionaries>\n <ResourceDictionary Source=\"/Microsoft.VisualStudio.Shell.StartPage;component/Styles/startpageresources.xaml\" />\n </ResourceDictionary.MergedDictionaries>\n </ResourceDictionary>\n </Grid.Resources>\n\n <Grid x:Name=\"LayoutRoot\"\n Background=\"{DynamicResource {x:Static vsfx:VsBrushes.StartPageBackgroundKey}}\"\n Style=\"{DynamicResource StartPage.OuterGridStyle}\">\n\n <Grid.ColumnDefinitions>\n <!-- Left Hand Column -->\n <!-- This column is just wide enough to fit the Command Buttons and Start Page Options.\n The Recent Project area is constrained to the width of the Commmand Buttons. -->\n <ColumnDefinition MinWidth=\"{Binding ElementName=commandButtonsGrid, Path=ActualWidth}\"\n Width=\"3*\" MaxWidth=\"330\" />\n <!-- Gutter -->\n <ColumnDefinition Width=\"6\"/>\n <!-- Allow main column to collapse to 0 -->\n <ColumnDefinition Width=\"7*\" MinWidth=\"0\"/>\n </Grid.ColumnDefinitions>\n\n <Grid.RowDefinitions>\n <!-- Logo-->\n <RowDefinition Height=\"130\" />\n <!-- Main Content Area -->\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <!--Logo Image -->\n <!--Note: To reference files relative to this XAML file, use syntax like the following: <Image Source=\"{sp:StartPageRelative myImage.png}\" .../> -->\n <Image Grid.Column=\"0\" Grid.Row=\"0\" Grid.ColumnSpan=\"3\"\n Source=\"{Binding Background.Logo}\"\n HorizontalAlignment=\"Left\"\n VerticalAlignment=\"Top\" Width=\"1600\" />\n\n <!--Left Column-->\n <Grid Width=\"Auto\" Grid.Column=\"0\" Grid.Row=\"1\"\n Margin=\"15,-35,0,15\" VerticalAlignment=\"Stretch\">\n <Grid.RowDefinitions>\n <!-- Command Buttons for New Projects -->\n <RowDefinition Height=\"Auto\"/>\n <!-- MRU Row -->\n <RowDefinition Height=\"*\"/>\n <!--Gutter at bottom of page -->\n <RowDefinition Height=\"Auto\"/>\n </Grid.RowDefinitions>\n\n <!-- Command Buttons -->\n <Grid x:Name=\"commandButtonsGrid\" MinWidth=\"270\"\n Grid.Row=\"0\" Margin=\"0,15,0,30\" HorizontalAlignment=\"Left\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"3\"/>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"3\"/>\n <RowDefinition Height=\"Auto\"/>\n </Grid.RowDefinitions>\n <!-- ... -->\n\n </Grid>\n\n\n <!-- Recent Projects Section -->\n <Grid Grid.Row=\"1\" HorizontalAlignment=\"Left\" Width=\"Auto\">\n <Grid.RowDefinitions>\n <!-- Heading -->\n <RowDefinition Height=\"Auto\" />\n <!-- MRU Container -->\n <RowDefinition Height=\"*\" />\n </Grid.RowDefinitions>\n\n <!-- Recent Projects Heading-->\n <StackPanel Grid.Row=\"0\" Margin=\"0,0,0,10\" Orientation=\"Horizontal\">\n <TextBlock Text=\"Recent Projects\" VerticalAlignment=\"Top\"\n Style=\"{DynamicResource StartPage.HeadingTextStyle}\"\n x:Uid=\"RecentProjects\"/>\n <Path VerticalAlignment=\"Center\" Margin=\"6,0,0,-4\" Width=\"Auto\"\n Height=\"1\" Stretch=\"Fill\" StrokeThickness=\"1\" StrokeLineJoin=\"Round\"\n Stroke=\"{DynamicResource {x:Static vsfx:VsBrushes.StartPageSeparatorKey}}\"\n Data=\"F1 M 0.5,0.5L 199.5,0.5\"/>\n </StackPanel>\n <!-- MRU List Container -->\n\n <!-- ... -->\n\n </Grid>\n\n <!-- Start Page Options -->\n <StackPanel Margin=\"0,5,0,0\" Grid.Column=\"0\" Grid.Row=\"2\">\n <CheckBox x:Uid=\"AutoClose_Option\" Content=\"Close page after project load\"\n IsChecked=\"{Binding ClosePageOnOpenProject, Mode=TwoWay}\"\n Margin=\"0,0,2,0\"/>\n <CheckBox x:Uid=\"ShowOnStartUp_Option\" Content=\"Show page on startup\"\n IsChecked=\"{Binding ShowPageAtStartup, Mode=TwoWay}\"\n Margin=\"0,2,0,0\"/>\n </StackPanel>\n </Grid>\n\n <!--Center Content-->\n <Grid Grid.Column=\"2\" Grid.Row=\"1\" Margin=\"0,-35,15,15\">\n <TabControl Style=\"{DynamicResource StartPage.TabControlStyle}\"\n SelectedIndex=\"{Binding SelectedTabItemIndex, Mode=TwoWay}\">\n\n <!-- ... -->\n\n </TabControl>\n </Grid>\n </Grid>\n</Grid>Как видно, при описании страницы используются ряд стандартных пространств имен. Они необходимы для получения информации для отображения, а также для выполнения команд. По этой разметке нетрудно догадаться каким образом определяется содержимое страницы. Видно также, что для основного содержимого используется элемент управления TabControl, который содержит ряд стандартных вкладок.
Если нам не требуется радикально изменять внешний вид стартовой страницы, то рекомендуется создавать набор необходимых вкладок, которые будут отображать нужную информацию. Как раз здесь и задается дополнительная вкладка для нашего содержимого. Эта вкладка содержит ссылку ну элемент управления, определенный в дополнительной сборке.
\n<TabControl Style=\"{DynamicResource StartPage.TabControlStyle}\"\n SelectedIndex=\"{Binding SelectedTabItemIndex, Mode=TwoWay}\">\n\n <!-- ... -->\n\n <TabItem Header=\"MyControl\" Style=\"{DynamicResource StartPage.TabItemStyle}\">\n <my:MyControl/>\n </TabItem>\n</TabControl>В нашем случае давайте воспользуемся этим подходом и не будем модифицировать основной файл страницы. Вместо этого добавим свою функциональность во внешний элемент управления.
\nДавайте создадим специальную вкладку, на которой будем видеть все наши задачи, которые находятся у нас в данный момент в Outlook 2010. Для этого в элемент управления MyControl добавим элемент ListBox, который и будет содержать список задач из Outlook.
<ListBox x:Name=\"Tasks\"\n Foreground=\"{DynamicResource {x:Static vsfx:VsBrushes.StartPageTextBodyKey}}\"\n Background=\"Transparent\">\n <ListBox.ItemTemplate>\n <DataTemplate>\n <TextBlock Text=\"{Binding }\" Margin=\"20\" FontSize=\"16\" />\n </DataTemplate>\n </ListBox.ItemTemplate>\n</ListBox>Теперь определим обработчик загрузки элемента управления, в котором будет содержаться логика получения элементов из Outlook. Для получения данных воспользуемся интерфейсами COM, для чего сделаем ссылку на Microsoft.Office.Interop.Outlook. Код для получения информации выглядит очень просто – в нем происходит обращение к Outlook и отображение полученных данных в созданном ранее элементе управления ListBox.
private void UserControl_Loaded(object sender, RoutedEventArgs e)\n{\n var app = new Outlook.Application();\n var folder = app.Session.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderTasks);\n Tasks.ItemsSource = folder.Items.OfType<Outlook.TaskItem>().Select(t => t.Subject);\n}Теперь запустим проект и увидим, что появилась новая вкладка, в которой содержаться все актуальные задачи.
\n\n\n\n![\"Стартовая](\"https://blog.zwezdin.com/2010/visual-studio-2010-start-screen/1cc5a2e6/4@2x.png\")
\n\n\n\n\nВ данном случае расширение получилось очень простым. Однако, аналогичным образом доработать его до требуемого результата достаточно просто.
\nТаким образом, мы без особых усилий изменили вид стартовой страницы Visual Studio 2010 разместив на ней нужное нам содержимое.
", "tags": [ "Visual Studio", "WPF", "XAML" ], "banner_image": "https://blog.zwezdin.com/2010/visual-studio-2010-start-screen/e64b6257/visual_studio-2010-start-screen@cover.png" }, { "id": "https://blog.zwezdin.com/2010/visual-studio-developer-contest-results/", "url": "https://blog.zwezdin.com/2010/visual-studio-developer-contest-results/", "title": "Итоги конкурса статей по Visual Studio 2010", "date_published": "2010-05-20T12:00:00.000Z", "content_html": "В начале апреля мы объявили конкурс статей о разработке с Visual Studio 2010. Пришло время подвести итоги и назвать победителей.
\nДля начала хотелось бы сказать, что все получилось не совсем так, как хотелось бы. Участников конкурса было не так много. С другой стороны статьи получились действительно интересными и полезными каждая по-своему, за что хотелось бы поблагодарить их авторов. Итак, теперь о результатах.
\nПосле небольшого обсуждения жюри пришло к выводу, что призы должны распределиться следующим образом.
\nГлавный приз мышь Microsoft SideWinder Gaming Laser Mouse получает Denis Liger, написавший в общей сложности 5 статей. Кроме того, к основному призу прилагается пивной бокал MSDN, книга “Windows для профессионалов” и сертификат на бесплатную сдачу экзамена MCP.
\nВторой приз Microsoft LifeCam VX-5000 получает Roman Kurbangaliev за интереснейший обзор расширений для Visual Studio. Кроме того, к основному призу прилагается пивной бокал MSDN, книга “Windows для профессионалов” и сертификат на бесплатную сдачу экзамена MCP.
\nПоощрительные призы в виде пивного бокала MSDN, книги “Windows для профессионалов” и двух сертификатов на бесплатную сдачу экзамена MCP получают Курманов Самат и Иван Андреев за их замечательные статьи про разработку игр для Windows Phone 7 и создание медиа-плеера в Visual Studio 2010.
\nКроме того, Владимир Юнев (Microsoft MVP и активный участник сообщества Хабрахабр) предоставил дополнительные призы для авторов этих статей – приглашение на вступление в закрытое сообщество Хабрахабр, за что ему отдельное спасибо.
\nДля получения своих призов всем победителям нужно написать мне на электронную почту адрес доставки.
\nНесмотря на то, что статей было не так много как хотелось бы, все равно получилось очень интересно, ну а призы нашли своих законных владельцев. Спасибо всем участникам за интересные работы, а также участникам жюри за их посильный вклад в данный конкурс.
", "tags": [ "Visual Studio", "Конкурсы" ], "banner_image": "https://blog.zwezdin.com/2010/visual-studio-developer-contest-results/7110840c/visual_studio-developer-contest-results@cover.jpg" }, { "id": "https://blog.zwezdin.com/2010/windows-phone-ink/", "url": "https://blog.zwezdin.com/2010/windows-phone-ink/", "title": "Рукописный ввод в Windows Phone 7", "date_published": "2010-05-02T12:00:00.000Z", "content_html": "Ввод информации в Windows Phone 7 осуществляется путем использования встроенной программной или аппаратной (на некоторых устройствах) клавиатуры. Программная клавиатура способна подстраиваться под текущую ситуацию, в которой находится пользователь. Тем не менее, иногда может потребоваться нарисовать что-то на экране – в этом случае необходим рукописный ввод.
\n\n\n\n![\"Рукописный](\"https://blog.zwezdin.com/2010/windows-phone-ink/2482cac0/1@2x.png\")
\n\n\n\n\nРукописный ввод хорошо использовать когда нужно что-то нарисовать – небольшую картинку, например, или оставить свою подпись на экране. Такие задачи встречаются не слишком часто, но тем не менее они появляются. Для того, чтобы реализовать в приложении такую функциональность можно воспользоваться объектом InkPresenter. Для этого просто добавим его на форму.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"InkTest.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n\n <Grid x:Name=\"LayoutRoot\" Background=\"{StaticResource PhoneBackgroundBrush}\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\" Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"Ink\" x:Name=\"textBlockListTitle\" Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n <InkPresenter Background=\"White\" x:Name=\"ink1\" />\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>Однако, простого добавления элемента на форму будет недостаточно. После добавление необходимо обработать несколько событий – MouseMove, MouseLeftButtonDown и MouseLeftButtonUp.
Дело в том, что объект InkPresenter содержит коллекцию Strokes, которая объекты Stroke. Stroke — это набор точек, нарисованных пользователем. Наша задача заключается в том, чтобы при нажатии и перемещении указателя сохранять все координаты в объект Stroke и при отпускании добавить все эти точки в коллекцию Strokes объекта InkPresenter.
Для этих целей при нажатии на экран мы создадим новый объект Stroke и при перемещении указателя будем добавлять каждую точку в этот объект. Для этих целей будем использовать события MouseLeftButtonDown и MouseMove.
public MainPage()\n{\n InitializeComponent();\n\n SupportedOrientations = SupportedPageOrientation.Portrait | SupportedPageOrientation.Landscape;\n ink1.MouseMove += new MouseEventHandler(ink1_MouseMove);\n ink1.MouseLeftButtonDown += new MouseButtonEventHandler(ink1_MouseLeftButtonDown);\n}\n\nprivate Stroke _currentStroke;\n\nvoid ink1_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)\n{\n ink1.CaptureMouse();\n _currentStroke = new Stroke();\n _currentStroke.DrawingAttributes.Color = Colors.Red;\n\n var currentPosition = e.GetPosition(ink1);\n _currentStroke.StylusPoints.Add(new StylusPoint(currentPosition.X, currentPosition.Y));\n\n ink1.Strokes.Add(_currentStroke);\n}\n\nvoid ink1_MouseMove(object sender, MouseEventArgs e)\n{\n if (_currentStroke != null)\n {\n var currentPosition = e.GetPosition(ink1);\n _currentStroke.StylusPoints.Add(new StylusPoint(currentPosition.X, currentPosition.Y));\n }\n}После того, как пользователь нарисовал то, что хотел, нужно просто присвоить полю _currentStroke пустое значение (для того, чтобы больше не обрабатывалось событие MouseMove).
void ink1_MouseLeftButtonUp(object sender, MouseButtonEventArgs e)\n{\n _currentStroke = null;\n}После этого рукописный ввод уже будет работать. Давайте немного усовершенствуем наше приложение и добавим возможность отмены последнего ввода. Как вы, наверное, догадались, для этого необходимо удалить последний объект Stroke из коллекции Strokes.
Добавим меню, в котором будет пункт, позволяющий отменять последнее действие. Для этого сделаем ссылку на сборку Microsoft.Phone.Shell и определим пространство имен shell в XAML.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"InkTest.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n\n<!-- содержимое формы -->\n\n</phoneNavigation:PhoneApplicationPage>Осталось только определить содержимое меню и создать для него обработчик.
\n<phoneNavigation:PhoneApplicationPage\n x:Class=\"InkTest.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n <phoneNavigation:PhoneApplicationPage.ApplicationBar>\n <shell:ApplicationBar IsMenuEnabled=\"True\">\n <shell:ApplicationBar.MenuItems>\n <shell:ApplicationBarMenuItem Text=\"Undo\" Click=\"ApplicationBarMenuItem_Click\"/>\n </shell:ApplicationBar.MenuItems>\n </shell:ApplicationBar>\n </phoneNavigation:PhoneApplicationPage.ApplicationBar>\n\n <Grid x:Name=\"LayoutRoot\" Background=\"{StaticResource PhoneBackgroundBrush}\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\" Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"Ink\" x:Name=\"textBlockListTitle\" Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n <InkPresenter Background=\"White\" x:Name=\"ink1\" />\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>Обработчик для отмены ввода будет выглядеть очень просто – в нем мы проверим вводил ли пользователь что-либо, и если да, то удалим этот фрагмент (объект Stroke).
private void ApplicationBarMenuItem_Click(object sender, EventArgs e)\n{\n if (ink1.Strokes != null && ink1.Strokes.Count > 0)\n {\n ink1.Strokes.RemoveAt(ink1.Strokes.Count - 1);\n }\n}Теперь у нас есть возможность отменить последний ввод. Но что, делать, если мы отменили его случайно? Логично, что рядом с Undo должен быть и пункт Redo. Сделать его очень просто – нужно просто вернуть объект Stroke обратно в коллекцию Strokes. Давайте добавим еще один пункт меню и создадим для него обработчик.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"InkTest.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n <phoneNavigation:PhoneApplicationPage.ApplicationBar>\n <shell:ApplicationBar IsMenuEnabled=\"True\">\n <shell:ApplicationBar.MenuItems>\n <shell:ApplicationBarMenuItem Text=\"Undo\" Click=\"ApplicationBarMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Redo\" Click=\"ApplicationBarMenuItem_Click_1\"/>\n </shell:ApplicationBar.MenuItems>\n </shell:ApplicationBar>\n </phoneNavigation:PhoneApplicationPage.ApplicationBar>\n\n <Grid x:Name=\"LayoutRoot\" Background=\"{StaticResource PhoneBackgroundBrush}\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\" Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"Ink\" x:Name=\"textBlockListTitle\" Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n <InkPresenter Background=\"White\" x:Name=\"ink1\" />\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>Модифицируем обработчик отмены ввода таким образом, чтобы он сохранял удаленный объект. Обработчик для восстановления объекта просто будет добавлять к коллекцию этот удаленный объект. Сам удаленный объект будем хранить в локальном поле.
\nprivate void ApplicationBarMenuItem_Click(object sender, EventArgs e)\n{\n if (ink1.Strokes != null && ink1.Strokes.Count > 0)\n {\n _canceledStroke = ink1.Strokes.Last();\n ink1.Strokes.RemoveAt(ink1.Strokes.Count - 1);\n }\n}\n\nStroke _canceledStroke = null;\n\nprivate void ApplicationBarMenuItem_Click_1(object sender, EventArgs e)\n{\n if (_canceledStroke != null)\n {\n ink1.Strokes.Add(_canceledStroke);\n _canceledStroke = null;\n }\n}Понятно, что хранить только последнюю отмену – не очень правильно. Гораздо правильнее – хранить список, или лучше стек всех отмененных вводов. Но это я оставлю вам для тренировки пальцев.
\nНу и, наконец, давайте отобразим количество объектов в коллекции Strokes для большей наглядности. Я привяжу свойство Count к тексту на форме.
<TextBlock Text=\"{Binding ElementName=ink1, Path=Strokes.Count}\" x:Name=\"textBlockPageTitle\" Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>Теперь можно запустить приложение и попробовать нарисовать что-то очень красивое. Например, яблоко :).
\n\n\n\n![\"Рукописный](\"https://blog.zwezdin.com/2010/windows-phone-ink/74dcbf5e/2@2x.png\")
",
"tags": [
"Windows Phone"
],
"banner_image": "https://blog.zwezdin.com/2010/windows-phone-ink/c4eca1ee/windows_phone-ink@cover.png"
},
{
"id": "https://blog.zwezdin.com/2010/windows-phone-sqlite/",
"url": "https://blog.zwezdin.com/2010/windows-phone-sqlite/",
"title": "Использование SQLite в Windows Phone 7",
"date_published": "2010-05-01T12:00:00.000Z",
"content_html": "Я уже писал о том, как можно использовать встроенные средства для хранения данных в Windows Phone 7. Понятно, что для некоторых задач использование реляционного хранилища было бы намного удобнее и эффективнее. Тем не менее, в Windows Phone 7 CTP, представленном на MIX 2010 нет встроенной поддержки SQL Compact и пока не ясно, появится ли она в финальном релизе. Между тем, через несколько дней после официального выхода Windows Phone 7 SDK CTP было объявлено о портировании переносимой БД SQLite на Windows Phone 7. Как просили многие из вас, я расскажу о том, как это можно использовать в своих приложениях.
\nSQLite — это переносимая база данных, подобная SQL Compact и имеющая реализации для огромного числа платформ. Предпосылкой к переносу на Windows Phone 7, судя по всему, послужила уже существующая реализация для настольной версии Silverilght. Признаться честно, просмотрев исходные коды SQLite, я не могу сказать, что они мне нравятся. Однако, эта библиотека действительно работает на Windows Phone 7 и ее можно использовать в своих приложениях.
\nИтак, для того, чтобы использовать SQLite в своих приложениях нужно загрузить исходные коды библиотеки. Загрузив, не пугайтесь – исходные коды библиотеки занимают 10 Мб, это действительно так. Однако, не стоит переживать, при сборке проекта SQLite собирается в сборку размером в 600Кб (плюс, если необходимо, файл с отладочной информацией 1.4Мб). Размер библиотеки 600Кб – это, конечно, тоже не мало, но по сравнению с 10 Мб выглядит несущественно. Вместе с исходным кодом самой библиотеки поставляется пример приложения, работающего с SQLite. С него мы и начнем рассмотрение работы.
\nКак я и говорил, исходные коды SQLite оформлены очень специфично. Это, наверное, дело вкуса, поэтому пока не обращайте внимания на стиль написания кода. Демонстрационное приложение содержит несколько кнопок для выполнения операций – открытия/закрытия БД, создание таблицы, добавления информация и удаления БД. Для каждой из кнопок существует отдельный обработчик. Давайте посмотрим на каждый из них.
\nИсходный код:
\nSqlite3.sqlite3 db=null;\n\npublic bool OpenDB()\n{\n int rc;\n db = new Sqlite3.sqlite3();\n rc = Sqlite3.sqlite3_open(fileName, ref db);\n if (rc != 0)\n {\n lbOutput.Text += \"\\nCannot open database: \" + Sqlite3.sqlite3_errmsg(db);\n db = null;\n return false;\n }\n lbOutput.Text += \"\\nDatabase opened.\";\n return true;\n}\n\npublic bool CloseDB()\n{\n int rc;\n if (db != null)\n {\n rc = Sqlite3.sqlite3_close(db);\n if (rc != 0)\n {\n lbOutput.Text += \"\\nCannot close database: \" + Sqlite3.sqlite3_errmsg(db);\n db = null;\n return false;\n }\n }\n lbOutput.Text += \"\\nDatabase closed.\";\n return true;\n}Как видно, в форме сохраняется ссылка на объект Sqlite3.sqlite3, представляющий базу данных. Загрузка базы данных осуществляется посредством вызова метода Sqlite3.sqlite3_open. Закрытие текущей базы данных происходит путем вызова метода Sqlite3.sqlite3_close. Каждое из действий записывается в элемент lbOutput, которое находится на форме. Все остальные методы вызывают метод OpenDB в случае, если поле формы db оказывается пустым и используют открытую базу данных для дальнейших действий.
Исходный код:
\nprivate void btnTest_Click(object sender, RoutedEventArgs e)\n{\n int rc;\n string errMsg = string.Empty;\n if (db == null)\n if (!OpenDB())\n return;\n rc = Sqlite3.sqlite3_exec(db, btnCreate.Content.ToString().Substring(2), (Sqlite3.dxCallback)this.callback, null, ref errMsg);\n if (rc != Sqlite3.SQLITE_OK)\n lbOutput.Text += \"\\nError: \" + Sqlite3.sqlite3_errmsg(db);\n else\n lbOutput.Text += \"\\nCommand completed successfully\";\n}\n\nint callback(object pArg, System.Int64 nArg, object azArgs, object azCols)\n{\n int i;\n string[] azArg = (string[])azArgs;\n string[] azCol = (string[])azCols;\n String sb=\"\";// = new String();\n for (i = 0; i < nArg; i++)\n sb+=azCol[i] + \" = \" + azArg[i] + \"\\n\";\n lbOutput.Text += (\"\\n\" + sb.ToString());\n return 0;\n}\n\nprivate void btnDrop_Click(object sender, RoutedEventArgs e)\n{\n int rc;\n string errMsg = string.Empty;\n if (db == null)\n if (!OpenDB())\n return;\n rc = Sqlite3.sqlite3_exec(db, btnDrop.Content.ToString().Substring(2), (Sqlite3.dxCallback)this.callback, null, ref errMsg);\n if (rc != Sqlite3.SQLITE_OK)\n lbOutput.Text += \"\\nError: \" + Sqlite3.sqlite3_errmsg(db);\n else\n lbOutput.Text += \"\\nCommand completed successfully\";\n}На самом деле все дальнейшие операции по манипулированию данными – это выполнение SQL-команд. Для этого используется метод” sqlite3_exec, который принимает на вход текущее соединение с БД, SQL-код и метод для обратного вызова. Также на вход передается ссылка на объект-строку, куда будет помещено сообщение об ошибке, в случае если она произойдет. Как видно, в обоих методах перед выполнением проверяется текущее соединение с БД и, если оно закрыто, открывается. В качестве SQL-команды в метод передаются параметры btnCreate.Content.ToString().Substring(2) и btnDrop.Content.ToString().Substring(2) — дело в том, что ребята, создававшие пример поместили SQL-команды прямо внутрь текста кнопки.
Также очень загадочно выглядит метод обратного вызова. На самом деле в нем происходит обработка результата (в случае, если это выборка) и отображение его в том же элементе lbOutput.
Исходный код:
\nprivate void btnInsert_Click(object sender, RoutedEventArgs e)\n{\n int rc;\n string errMsg = string.Empty;\n if (db == null)\n if (!OpenDB())\n return;\n rc = Sqlite3.sqlite3_exec(db, btnInsert.Content.ToString().Substring(2), (Sqlite3.dxCallback)this.callback, null, ref errMsg);\n if (rc != Sqlite3.SQLITE_OK)\n lbOutput.Text += \"\\nError: \" + Sqlite3.sqlite3_errmsg(db);\n else\n lbOutput.Text += \"\\nCommand completed successfully\";\n}Собственно здесь подход ничем не отличается от предыдущего случая — для исполнения команды используется метод sqlite3_exec, ну а сама SQL-команда по-прежнему хранится внутри кнопки.
На самом деле исходный пример не содержал кода для выборки данных. Поэтому я решил восполнить этот пробел и написать в том же духе (нужно же соблюдать общий стиль) еще один метод для выборки данных.
\nИсходный код:
\nprivate void SelectData_Click(object sender, RoutedEventArgs e)\n{\n if (db == null)\n {\n if (!OpenDB())\n {\n return;\n }\n }\n\n string errMsg = string.Empty;\n\n int result = Sqlite3.sqlite3_exec(db, @\"select * from test\", (Sqlite3.dxCallback)this.callback, null, ref errMsg);\n if (result != Sqlite3.SQLITE_OK)\n lbOutput.Text += \"\\nError: \" + Sqlite3.sqlite3_errmsg(db);\n else\n lbOutput.Text += \"\\nCommand completed successfully\";\n}Как видно, здесь в метод sqlite3_exec передается SQL-команда для выборки данных. В этом случае как раз сработает callback-обработчик, который выведет полученные данные на форму.
Ну а теперь давайте попробуем создать собственное приложение на базе SQLite с более читаемым кодом и посмотрим на все сценарии.
\nПрежде всего здесь же создадим еще один проект для приложения Windows Phone 7 и сделаем ссылку на библиотеку SQLite. Добавим на форму несколько кнопок (добавление записей, очистка и получение записей из БД).
\n\n\n\n![\"Использование](\"https://blog.zwezdin.com/2010/windows-phone-sqlite/5657c78a/1@2x.png\")
\n\n\n\n\nПолучим небольшую несложную XAML-разметку.
\n<phoneNavigation:PhoneApplicationPage\n x:Class=\"DataDrivenApp.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n\n <Grid x:Name=\"LayoutRoot\" Background=\"{StaticResource PhoneBackgroundBrush}\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\" Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"Data\" x:Name=\"textBlockListTitle\" Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <StackPanel Orientation=\"Horizontal\">\n <Button Content=\"Add\" Click=\"AddButton_Click\"/>\n <Button Content=\"Clear\" Click=\"ClearButton_Click\"/>\n <Button Content=\"Refresh\" Click=\"RefreshButton_Click\"/>\n </StackPanel>\n\n <ListBox x:Name=\"Data\" Grid.Row=\"1\">\n </ListBox>\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>Теперь напишем небольшие обработчики для событий нажатия на каждую из кнопок.
\nСоздание БД и заполнение данными:
\nprivate void AddButton_Click(object sender, RoutedEventArgs e)\n{\n var db = new Sqlite3.sqlite3();\n\n if (Sqlite3.sqlite3_open(\"test.db\", ref db) == 0)\n {\n string errMsg = string.Empty;\n\n if (Sqlite3.sqlite3_exec(db, @\"create table peoples (id int primary key, name text)\",\n (Sqlite3.dxCallback)(delegate(object pArg, System.Int64 nArg, object azArgs, object azCols) { return 0; }),\n null, ref errMsg) == Sqlite3.SQLITE_OK)\n {\n for (int i = 1; i <= 20; i++)\n {\n Sqlite3.sqlite3_exec(db, String.Format(@\"Insert into peoples (id,name) values ({0}, \"\"{1}\"\")\", i, Guid.NewGuid().ToString().Replace(\"-\", \"\").Substring(1, 5)),\n (Sqlite3.dxCallback)(delegate(object pArg, System.Int64 nArg, object azArgs, object azCols) { return 0; }),\n null, ref errMsg);\n }\n\n MessageBox.Show(\"Created\", \"Data\", MessageBoxButton.OK);\n }\n else\n {\n MessageBox.Show(\"Table creating error\");\n }\n }\n else\n {\n MessageBox.Show(\"Db opening error\");\n }\n}Удаление БД:
\nprivate void ClearButton_Click(object sender, RoutedEventArgs e)\n{\n var db = new Sqlite3.sqlite3();\n\n if (Sqlite3.sqlite3_open(\"test.db\", ref db) == 0)\n {\n string errMsg = string.Empty;\n\n if (Sqlite3.sqlite3_exec(db, @\"drop table peoples\",\n (Sqlite3.dxCallback)(delegate(object pArg, System.Int64 nArg, object azArgs, object azCols) { return 0; }),\n null, ref errMsg) == Sqlite3.SQLITE_OK)\n {\n MessageBox.Show(\"Dropped\", \"Data\", MessageBoxButton.OK);\n }\n else\n {\n MessageBox.Show(\"Table dropping error\");\n }\n }\n else\n {\n MessageBox.Show(\"Db opening error\");\n }\n}Отображение информации на форме:
\nprivate void RefreshButton_Click(object sender, RoutedEventArgs e)\n{\n var db = new Sqlite3.sqlite3();\n\n if (Sqlite3.sqlite3_open(\"test.db\", ref db) == 0)\n {\n string errMsg = string.Empty;\n Data.Items.Clear();\n\n if (Sqlite3.sqlite3_exec(db, @\"select * from peoples\",\n (Sqlite3.dxCallback)(delegate(object pArg, System.Int64 nArg, object azArgs, object azCols)\n {\n Data.Items.Add(((string[])azArgs)[1]);\n return 0;\n }),\n null, ref errMsg) == Sqlite3.SQLITE_OK)\n {\n MessageBox.Show(\"Refreshed\", \"Data\", MessageBoxButton.OK);\n }\n else\n {\n MessageBox.Show(\"Table refreshing error\");\n }\n }\n else\n {\n MessageBox.Show(\"Db opening error\");\n }\n}В данном случае код стало немного более читаемым.
\nТаким образом, работа с реляционными структурами в Windows Phone 7 возможна уже сегодня и вы можете использовать SQLite в ваших приложениях, если вам недостаточно функциональности Isolated Storage.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-phone-sqlite/a5ee4726/windows_phone-sqlite@cover.jpg" }, { "id": "https://blog.zwezdin.com/2010/windows-phone-isolated-storage/", "url": "https://blog.zwezdin.com/2010/windows-phone-isolated-storage/", "title": "Хранение данных в Windows Phone 7 средствами Isolated Storage", "date_published": "2010-04-30T12:00:00.000Z", "content_html": "Вопрос хранения данных затрагивает практически любое приложения и не может оставаться в стороне. При разработке приложений для Windows Phone 7 в качестве основного сценария на данный момент предлагается использовать механизм Isolated Storage, который успешно используется в приложениях Silverlight. Давайте попробуем поработать с Isolated Storage.
\nIsolated Storage предполагает, что для каждого приложения существует изолированная среда для хранения данных.Приложения не могут получать доступ к хранилищу других приложений (в основном из соображений безопасности). Само хранилище при этом разделяется на две части:
\nХранилище Isolated Settings Storage предназначено для хранения настроек приложения. Хранение настроек осуществляется в специальном словаре (ключ-значение) и очень похоже на то, как работают аналогичные механизмы в настольной платформе.
\nХранилище Isolated File Storage предназначено для хранения различных данных в виде файлов. При этом это хранилище можно структурировать, используя разбиение на папки. Фактически, это – некоторый доступ к файловой системе изолированного хранилища.
\nДля организации механизма хранения данных в Windows Phone 7 SDK используется следующий набор объектов:
\nSystem.IO.IsolatedStorage.IsolatedStorageSettings – предоставляет доступ к словарю (ключ-значение) настроек для текущего хранилища (Isolated Settings Storage);System.IO.IsolatedStorage.IsolatedStorageFile – позволяет получить доступ к хранилищу данных (Isolated File Storage);System.IO.IsolatedStorage.IsolatedFileStream – позволяет получить доступ к содержимому файла в хранилище (Isolated File Storage);System.IO.IsolatedStorage.IsolatedStorageException – исключение, возникающее при ошибках в работе с хранилищем.Для доступа к настройкам приложения используется класс IsolatedStorageSettings. Этот класс представляет собой словарь, при помощи которого по ключу можно обратиться к конкретной настройке. Для доступа к значению используется индексатор. Например, получить доступ к ключу count можно используя следующий код.
int count = (int)System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings[\"count\"];Если указанного ключа нет в настройках приложения, то будет сгенерировано соответствующее исключение. Поэтому чтобы избежать подобных неприятностей следует проверять наличие нужного ключа перед обращением к нему.
\nint count = 0;\n\nif (System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings.Contains(\"count\") == true)\n{\n count = (int)System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings[\"count\"];\n}Аналогичным образом можно работать с любыми ключами Isolated Settings Storage.
\nИзменение настроек приложения также выполняется достаточно просто. Для этого следует изменить нужный ключ и вызвать метод Save.
System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings[\"count\"] = count;\nSystem.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings.Save();Так, например, можно написать несложный код по подсчету количества запусков приложения и отображения этой информации пользователю. Для этого добавим на форму элемент TextBlock и будем инкрементировать счетчик при каждом запуске приложения. Эту логику можно поместить, например, в конструктор.
public MainPage()\n{\n InitializeComponent();\n\n SupportedOrientations = SupportedPageOrientation.Portrait | SupportedPageOrientation.Landscape;\n\n int count = 0;\n if (System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings.Contains(\"count\") == true)\n {\n count = (int)System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings[\"count\"];\n }\n\n count++;\n System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings[\"count\"] = count;\n System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings.Save();\n\n textBlock1.Text = count.ToString();\n}На самом деле, работать с настройками в таком виде не очень удобно – каждый раз приходится проверять наличие ключа в настройках и выполнять приведение типов. По-хорошему, тут еще нужно проверять на соответствие типов перед выполнением приведения типов. Поэтому давайте создадим небольшую надстройку для класса IsolatedStorageSettings.
Надстройка будет представлять с собой несколько методов-расширений для класса IsolatedStorageSettings. Для получения настроек в типизированном виде создадим метод GetSetting, который будет принимать в качестве параметра имя ключа и значение по умолчанию (если, например, ключ не найден). Также сделаем перегруженную версию метода, чтобы можно было не указывать значение по умолчанию. Внутри этого метода выполним все действия, которые мы видели с вами раньше.
public static class IsolatedStorageSettingsExtensions\n{\n public static T GetSetting<T>(this System.IO.IsolatedStorage.IsolatedStorageSettings settings, string keyName)\n {\n return GetSetting(settings, keyName, default(T));\n }\n\n public static T GetSetting<T>(this System.IO.IsolatedStorage.IsolatedStorageSettings settings, string keyName, T defaultValue)\n {\n if (settings != null)\n {\n if (settings.Contains(keyName) == true)\n {\n try\n {\n return (T)settings[keyName];\n }\n catch (InvalidCastException)\n {\n }\n }\n }\n\n return defaultValue;\n }\n}Теперь доступ к настройкам немного упростился. Для того, чтобы получить значение, можно просто вызвать метод-расширение с нужными параметрами. Перепишем с учетом этого, код, который использовался выше.
\npublic MainPage()\n{\n InitializeComponent();\n\n SupportedOrientations = SupportedPageOrientation.Portrait | SupportedPageOrientation.Landscape;\n\n int count = System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings.GetSetting<int>(\"count\");\n count++;\n System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings[\"count\"] = count;\n System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings.Save();\n\n textBlock1.Text = count.ToString();\n}Мы также можем указать значение по умолчанию, которое будет использоваться, если ключ не найден в настройках. Например, мы можем вести отсчет с числа 10.
int count = System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings.GetSetting<int>(\"count\", 10);Аналогичный метод расширения сделаем и для сохранения настроек. Тогда весь класс, содержащий методы-расширения будет выглядеть следующим образом.
\npublic static class IsolatedStorageSettingsExtensions\n{\n public static T GetSetting<T>(this System.IO.IsolatedStorage.IsolatedStorageSettings settings, string keyName)\n {\n return GetSetting(settings, keyName, default(T));\n }\n\n public static T GetSetting<T>(this System.IO.IsolatedStorage.IsolatedStorageSettings settings, string keyName, T defaultValue)\n {\n if (settings != null)\n {\n if (settings.Contains(keyName) == true)\n {\n try\n {\n return (T)settings[keyName];\n }\n catch (InvalidCastException)\n {\n }\n }\n }\n\n return defaultValue;\n }\n\n public static void SaveSetting<T>(this System.IO.IsolatedStorage.IsolatedStorageSettings settings, string keyName, T value)\n {\n if (settings != null)\n {\n settings[keyName] = value;\n settings.Save();\n }\n }\n}При этом немного упростится код, считывающий и изменяющий настройки приложения.
\npublic MainPage()\n{\n InitializeComponent();\n\n SupportedOrientations = SupportedPageOrientation.Portrait | SupportedPageOrientation.Landscape;\n\n int count = System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings.GetSetting<int>(\"count\", 10);\n System.IO.IsolatedStorage.IsolatedStorageSettings.ApplicationSettings.SaveSetting(\"count\", ++count);\n textBlock1.Text = count.ToString();\n}Для доступа к файловому хранилищу используется класс IsolatedStorageFile. Обратившись к его статическому методу GetUserStoreForApplication() можно получить доступ к объекту, предоставляющему всевозможные методы для работы с файлами и папками:
GetDirectoryNames – позволяет получить список всех папок в заданном контексте;GetFileNames – позволяет получить список всех файлов в заданном контексте;CreateDirectory – позволяет создать папку;DeleteDirectory – позволяет удалить папку;DirectoryExists – позволяет проверить наличие папки;CreateFile – позволяет создать файл;OpenFile – позволяет открыть файл для чтения и/или изменения;DeleteFile – позволяет удалить файл;FileExists – позволяет проверить наличие файла.Как видно, для работы с файлом используется метод OpenFile. Этот файл возвращает поток, с которым можно работать так, как мы это делаем обычно (например, используя StreamReader/StreamWriter). Например, код для записи информации в файл будет выглядеть следующим образом.
using (var file = IsolatedStorageFile.GetUserStoreForApplication().CreateFile(\"test1.txt\"))\n{\n using (var fileWriter = new StreamWriter(file))\n {\n fileWriter.WriteLine(DateTime.Now.ToString());\n }\n}Аналогичным образом выглядит код для считывания содержимого файла.
\nusing (var file = IsolatedStorageFile.GetUserStoreForApplication().OpenFile(\"test1.txt\", FileMode.Open))\n{\n using (var fileReader = new StreamReader(file))\n {\n MessageBox.Show(fileReader.ReadToEnd(), \"File\", MessageBoxButton.OK);\n }\n}Давайте добавим в конструктор нашего приложения логику, согласно которой приложение будет проверять наличие файла в хранилище и, если его там нет, записывать в него текущее время; в противном случае – отображать его пользователю.
\npublic MainPage()\n{\n // ...\n\n if (IsolatedStorageFile.GetUserStoreForApplication().FileExists(\"test1.txt\") == false)\n {\n using (var file = IsolatedStorageFile.GetUserStoreForApplication().CreateFile(\"test1.txt\"))\n {\n using (var fileWriter = new StreamWriter(file))\n {\n fileWriter.WriteLine(DateTime.Now.ToString());\n }\n }\n }\n else\n {\n using (var file = IsolatedStorageFile.GetUserStoreForApplication().OpenFile(\"test1.txt\", FileMode.Open))\n {\n using (var fileReader = new StreamReader(file))\n {\n MessageBox.Show(fileReader.ReadToEnd(), \"File\", MessageBoxButton.OK);\n }\n }\n }\n}Таким образом, без особых усилий мы создали небольшое приложение, работающее с Isolated Storage - Isolated Settings Storage и Isolated File Storage. Как видно, на это не требуется много усилий, а работа с хранилищем очень похожа на аналогичные операции в настольном Silverilght. Тем не менее, по сравнению с хранилищем в Silverilght, хранилище в Windows Phone не имеет ограничений, связанных с объемом хранимой информации.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-phone-isolated-storage/f83fb100/windows_phone-isolated-storage@cover.jpg" }, { "id": "https://blog.zwezdin.com/2010/windows-mobile-autorun/", "url": "https://blog.zwezdin.com/2010/windows-mobile-autorun/", "title": "Автоматический запуск приложений в Windows Phone Classic", "date_published": "2010-04-29T12:00:00.000Z", "content_html": "Моя недавняя тема про фоновые службы в Windows Phone Classic (на базе управляемого кода) дала повод поразмышлять на тему автоматического запуска любых приложений для Windows Phone Classic.
\nСуществует два главных способа заставить приложение запускаться при загрузке операционной системы:
\nКроме того, есть варианты запускать приложения:
\nПо аналогии с настольной версией Windows, запускать приложения автоматически можно просто разместив информацию о них в специальной ветке реестра. Для этого используется секция HKEY_LOCAL_MACHINE\\Init. Для каждого отдельного приложения здесь создается отдельный ключ, имя которого LaunchXX, где XX – номер загрузки для приложения. Этот ключ должен содержать строковое значение – путь до приложения. Также можно создать второй, опциональный ключ с именем DependXX. В нем указывается номер приложения, которого следует ожидать до запуска данного приложения.
![\"Автоматический](\"https://blog.zwezdin.com/2010/windows-mobile-autorun/56c4dec1/1@2x.png\")
\n\n\n\n\nПонятно, что чтобы зарегистрировать свое приложение следует найти “свободный” номер и сохранить туда путь до своего приложения. Для этих целей можно использовать следующий код.
\nprivate void Register()\n{\n using (var key = Registry.LocalMachine.OpenSubKey(\"init\", true))\n {\n var values = key.GetValueNames();\n int keyIndex;\n for (keyIndex = 100; keyIndex < 199; keyIndex++)\n {\n if (values.Contains(\"Launch\" + keyIndex) == false)\n {\n break;\n }\n }\n\n key.SetValue(\"Launch\" + keyIndex, @\"path\");\n }\n}Для того, чтобы удалить приложение из автозапуска нужно просто удалить ключ. Соответственно понять, будет ли приложение в автозапуске можно путем поиска ключа с нужным значением. Набросаем для этих целей тоже небольшой фрагмент кода.
\npublic static bool IsServiceRegistered\n{\n get\n {\n var serviceFullPath = \"path\".ToLower();\n\n using (var key = Registry.LocalMachine.OpenSubKey(\"init\", true))\n {\n if (key != null)\n {\n return key.GetValueNames()\n .Where(k => (key.GetValue(k, String.Empty) ?? String.Empty).ToString()== serviceFullPath)\n .Count() > 0;\n }\n }\n\n return false;\n }\n}\n\npublic static void UnRegister()\n{\n\n var serviceFullPath = \"path\".ToLower();\n\n using (var key = Registry.LocalMachine.OpenSubKey(\"init\", true))\n {\n if (key != null)\n {\n var keyVaues = key.GetValueNames().Where(\n k => (key.GetValue(k, String.Empty) ?? String.Empty).ToString().ToLower() == serviceFullPath)\n .Select(k => k).\n ToArray();\n\n foreach (var keyVaue in keyVaues)\n {\n key.DeleteValue(keyVaue, false);\n }\n }\n }\n}После запуска приложения в автоматическом режиме следует уведомить операционную систему о том, что запуск произошел успешно. Для этого в coredll.dll содержится функция SignalStarted. Поскольку в данном случае мы имеем дело с приложением .NET Compact Framework, то следует использовать P/Invoke. При запуске приложения в автоматическом режиме приложению передается аргумент – так можно отличить автозапуск от обычного старта приложения. Этот аргумент следует передать в виде параметра функции SignalStarted.
static class Program\n{\n static void Main(string[] args)\n {\n if (args.Length > 0)\n {\n SignalStarted(uint.Parse(args[0]));\n }\n\n // запуск приложения\n }\n\n [DllImport(\"coredll\")]\n public extern static void SignalStarted(uint dword);\n}Теперь при загрузке операционной системы наше приложение будет успешно запускаться.
\nСтоит отметить, что операционная система имеет ряд ограничений на запуск приложений подобным образом. Например, приложение должно быть подписано действительным сертификатом. Кроме того, на некоторых устройствах запуск приложений данным способом ограничен. Также, в некоторых случаях может оказаться недостаточно прав доступа на запись в указанную ветку реестра (для разных устройств). Все это, к сожалению, ограничивает область применения данного способа.
\nДругим, наиболее простым вариантом является создание ярлыка в папке автозагрузки. Опять таки это аналог того, что есть в настольной версии Windows. В этом случае на приложение не накладывается ограничение, связанное с подписью приложения и оно гарантированно запустится. Единственное ограничение, связанное с подобным подходом заключается в том, что мы не сможем задать зависимости, как это было в предыдущем случае. Однако, это не всегда нужно.
\nВсе ярлыки для автозапуска должны располагаться в папке \\Windows\\StartUp. Однако, полный путь зависит в т.ч. от локализации устройства, например, для русской версии ОС путь будет выглядеть как \\Windows\\Автозагрузка. Тем не менее, это - не проблема, используя метод GetFolderPath объекта Environment мы можем получить путь к служебным папкам устройства, среди которых есть и папка автозагрузки. Поэтому путь до нашего ярлыка автозапуска можно определить так:
string _shortcutPath = Path.Combine(Environment.GetFolderPath(System.Environment.SpecialFolder.Startup), \"myapp.lnk\");Теперь, для того, чтобы автоматически загружать наше приложение, следует создать ярлык по этому пути. Этот файл имеет обычное текстовое содержимое вида XX#path, где XX – количество символов в части path, а path – путь до исполняемого файла. Однако, для создания ярлыка можно воспользоваться более правильным способом, а именно использовать функцию SHCreateShortcut из библиотеки coredll.dll. При вызове этой функции следует указать путь, где необходимо разместить ярлык (в папке автозагрузки) и путь до исполняемого файла.
[DllImport(\"coredll.dll\")]\npublic static extern void SHCreateShortcut(\n string target,\n string shortcut);\n\nprivate static string _shortcutPath =\n Path.Combine(Environment.GetFolderPath(System.Environment.SpecialFolder.Startup), \"myapp.lnk\");\n\nprivate void Register()\n{\n if (File.Exists(_shortcutPath) == true)\n {\n File.Delete(_shortcutPath);\n }\n\n SHCreateShortcut(_shortcutPath, \"path\");\n}Удаление приложения из автозагрузки или проверка наличия его там сводится к работе с этим файлом (ярлыком).
\nprivate static string _shortcutPath =\n Path.Combine(Environment.GetFolderPath(System.Environment.SpecialFolder.Startup), \"myapp.lnk\");\n\npublic static bool IsServiceRegistered\n{\n get\n {\n return File.Exists(_shortcutPath);\n }\n}\n\npublic static void UnRegister()\n{\n if (File.Exists(_shortcutPath) == true)\n {\n File.Delete(_shortcutPath);\n }\n}При вставке карты памяти операционная система автоматически сканирует ее на наличие приложения Autorun.exe в папке /2577, если приложение найдено, то оно запускается автоматически. На самом деле имя папки зависит от типа процессора и для некоторых моделей может быть иным. Однако, /2577 подходит для большинства устройств Windows Phone Classic.
В приведенном примере приложение должно находится на карте памяти в строго определенном месте. Если приложение находится по другому пути на карте памяти, то можно создать приложение Autorun.exe, которое будет запускать приложение по другому указанному пути.
Кроме того, если необходимо, чтобы приложение хранилось в основной памяти и не зависело от содержимого карты памяти, то можно воспользоваться другим способом, о котором речь пойдет далее.
\nОперационная система позволяет задать таймер для запуска приложения. Для этих целей существует функция CeRunApAtTime в библиотеке coredll.dll. Поскольку библиотека работает на основе неуправляемого кода, следует использовать P/Invoke для вызова функции. Перед этим следует определить структуру SystemTime, которая понадобится при вызове функций.
[StructLayout(LayoutKind.Sequential)]\npublic class SystemTime\n{\n public ushort wYear;\n public ushort wMonth;\n public ushort wDayOfWeek;\n public ushort wDay;\n public ushort wHour;\n public ushort wMinute;\n public ushort wSecond;\n public ushort wMilliseconds;\n}Для вызова функций следует сделать обертку над ними.
\npublic static class TimeLuanchHelper\n{\n [DllImport(\"coredll.dll\")]\n public static extern int CeRunAppAtTime(string application, SystemTime startTime);\n\n [DllImport(\"coredll.dll\")]\n public static extern int FileTimeToSystemTime(ref long lpFileTime, SystemTime lpSystemTime);\n [DllImport(\"coredll.dll\")]\n public static extern int FileTimeToLocalFileTime(ref long lpFileTime, ref long lpLocalFileTime);\n}Как видно, здесь мы воспользовались еще двумя системными функциями, которые позволяют работать со временем. Ну и, наконец, добавим нужные нам методы для отложенного запуска.
\npublic static class TimeLuanchHelper\n{\n [DllImport(\"coredll.dll\")]\n public static extern int CeRunAppAtTime(string application, SystemTime startTime);\n\n [DllImport(\"coredll.dll\")]\n public static extern int FileTimeToSystemTime(ref long lpFileTime, SystemTime lpSystemTime);\n [DllImport(\"coredll.dll\")]\n public static extern int FileTimeToLocalFileTime(ref long lpFileTime, ref long lpLocalFileTime);\n\n public static void ScheduleRun(string application, DateTime startTime)\n {\n long fileTimeUTC = startTime.ToFileTime();\n long fileTimeLocal = 0;\n SystemTime timeToStart = new SystemTime();\n FileTimeToLocalFileTime(ref fileTimeUTC, ref fileTimeLocal);\n FileTimeToSystemTime(ref fileTimeLocal, timeToStart);\n CeRunAppAtTime(application, timeToStart);\n\n }\n\n public static void ScheduleRun(string application, TimeSpan timeDisplacement)\n {\n var timeToStart = DateTime.Now + timeDisplacement;\n ScheduleRun(application, timeToStart);\n }\n}Теперь мы можем вызвать метод ScheduleRun и указать абсолютное или относительное время для запуска приложения.
Операционная система дает возможность запускать приложения при наступлении различных событий в системе. Например, можно запускать приложения в момент восстановления устройства из режима сна, в момент подключения или отключения от сети или после окончания синхронизации устройства через ActiveSync (полный список – ниже).
\nДля определения событий используется функция CeRunAppAtEvent библиотеки coredll.dll. В параметрах этой библиотеки следует передать путь до приложения и идентификатор события для срабатывания. Создадим для этой функции небольшую обертку.
public static class EventLuanchHelper\n{\n [DllImport(\"coredll.dll\")]\n public static extern int CeRunAppAtEvent(string application, int EventID);\n}Для передачи идентификатора события удобнее пользоваться названиями событий, а не их кодами. Поэтому поместим все события в отдельную структуру.
\npublic enum EventId\n{\n NOTIFICATION_EVENT_NONE = 0,\n NOTIFICATION_EVENT_TIME_CHANGE = 1,\n NOTIFICATION_EVENT_SYNC_END = 2,\n NOTIFICATION_EVENT_ON_AC_POWER = 3,\n NOTIFICATION_EVENT_OFF_AC_POWER = 4,\n NOTIFICATION_EVENT_NET_CONNECT = 5,\n NOTIFICATION_EVENT_NET_DISCONNECT = 6,\n NOTIFICATION_EVENT_DEVICE_CHANGE = 7,\n NOTIFICATION_EVENT_IR_DISCOVERED = 8,\n NOTIFICATION_EVENT_RS232_DETECTED = 9,\n NOTIFICATION_EVENT_RESTORE_END = 10,\n NOTIFICATION_EVENT_WAKEUP = 11,\n NOTIFICATION_EVENT_TZ_CHANGE = 12,\n NOTIFICATION_EVENT_MACHINE_NAME_CHANGE = 13\n};Теперь мы можем вызвать метод CeRunAppAtEvent и указать нужное событие.
EventLuanchHelper.CeRunAppAtEvent(\"path\", (int) EventId.NOTIFICATION_EVENT_ON_AC_POWER);Если необходимо отменить поведение запуска приложение на срабатывание события, то нужно вызвать метод с параметром NOTIFICATION_EVENT_NONE.
EventLuanchHelper.CeRunAppAtEvent(\"path\", (int)EventId.NOTIFICATION_EVENT_NONE);Список доступных событий:
\nNOTIFICATION_EVENT_TIME_CHANGE – изменение времени;NOTIFICATION_EVENT_SYNC_END – завершение синхронизации через ActiveSync;NOTIFICATION_EVENT_ON_AC_POWER – подключение внешнего источника питания;NOTIFICATION_EVENT_OFF_AC_POWER – отключение внешнего источника питания;NOTIFICATION_EVENT_NET_CONNECT – подключение к сети;NOTIFICATION_EVENT_NET_DISCONNECT – отключение от сети;NOTIFICATION_EVENT_DEVICE_CHANGE – подключено устройство (например, вставлена карта памяти);NOTIFICATION_EVENT_IR_DISCOVERED – соединение по ИК-порту;NOTIFICATION_EVENT_RS232_DETECTED – соединение по интерфейсу RS-232;NOTIFICATION_EVENT_WAKEUP – выход из режима сна;NOTIFICATION_EVENT_TZ_CHANGE – изменение временной зоны;NOTIFICATION_EVENT_MACHINE_NAME_CHANGE – изменение имени устройства.После того, как я рассказал (здесь и здесь) о механизме уведомлений для Windows Phone 7 некоторые из вас немного огорчились, что я не описал смысл заголовка X-NotificationClass, отправляемого вместе с самим уведомлением. Исправляюсь.
Итак, как мы помним, для отправки какого-либо уведомления мы используем адрес, полученный от сервиса в облаке и переданный третьему приложению для отправки уведомлений. Например, для отправки Toast-уведомления мы использовали с вами следующий программный код:
\nclass Program\n{\n private const string Url = @\"http://sn1.notify.live.net/throttledthirdparty/01.00/AAFTkavjFpAuT4i1fIKvueDiAgoOs1ADAgAAAAQOMDAwAAAAAAAAAAAAAAA\";\n\n static void Main(string[] args)\n {\n Console.Write(\"Header: \");\n string header = Console.ReadLine();\n Console.Write(\"Text: \");\n string text = Console.ReadLine();\n SendToast(Url, header, text);\n Console.ReadLine();\n }\n\n static void SendToast(string uri, string header, string text)\n {\n var client = new WebClient();\n\n client.Headers.Add(\"Content-Type\", \"text/html\");\n client.Headers.Add(\"X-NotificationClass\", \"2\");\n\n var message = \"X-WindowsPhone-Target: toast\" + Environment.NewLine + Environment.NewLine +\n @\"<?xml version=\"\"1.0\"\" encoding=\"\"utf-8\"\"?>\n <wp:PushNotification xmlns:wp=\"\"WindowsPhonePushNotification\"\">\n <wp:Toast>\n <wp:Text1>{0}</wp:Text1>\n <wp:Text2>{1}</wp:Text2>\n </wp:Toast>\n </wp:PushNotification>\";\n\n var result = client.UploadString(uri, \"POST\", String.Format(message, header, text));\n Console.WriteLine(result);\n Console.WriteLine(\"Device status is {0}\", client.ResponseHeaders[\"X-DeviceConnectionStatus\"]);\n Console.WriteLine(\"Notification status is {0}\", client.ResponseHeaders[\"X-NotificationStatus\"]);\n }\n}Как видно, перед отправкой сообщения мы определяем специальный HTTP-заголовок X-NotificationClass, который в каждом случае имеет разные значения. Какие значения может принимать этот заголовок и для чего он нужен? Давайте разберемся.
На самом деле этот заголовок выполняет две важные функции – определение типа уведомления и задание приоритета самого сообщения. Как я уже говорил, существует три типа уведомлений:
\nВыбор типа уведомления (Tile, Toast или Raw) зависит от того, какой диапазон значений используется. Уже внутри этого диапазона выбираются приоритеты.
\nДля Tile Notifications вы можете использовать одно из следующих значений в зависимости от приоритета:
\nДля Toast Notifications вы можете использовать одно из следующих значений в зависимости от приоритета:
\nДля Raw Notifications вы можете использовать одно из следующих значений в зависимости от приоритета:
\nТаким образом, при отправке уведомлений мы можем изменять их тип и приоритет.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-phone-notification-class/04a37861/windows_phone-notification-class@cover.jpg" }, { "id": "https://blog.zwezdin.com/2010/windows-phone-classic-compatibility/", "url": "https://blog.zwezdin.com/2010/windows-phone-classic-compatibility/", "title": "Совместимость приложений Windows Phone Classic и Windows Phone 7", "date_published": "2010-04-28T12:00:00.000Z", "content_html": "После анонса Windows Phone 7 и первых технических деталей о новой мобильной платформе от Microsoft, стало известно, что обратной совместимости приложений с Windows Phone Classic не будет. По моим наблюдениям, на эту тему началось множество различных спекуляций и провокаций. Здесь я хотел бы подробно обсудить эту тему и рассказать о том, как обстоят дела на самом деле.
\nИтак, первое о чем сразу же хотелось бы сказать – обратной совместимости на уровне бинарников действительно нет. Это значит, что вы не можете взять готовое приложение для Windows Phone Classic и запустить его на Windows Phone 7 – этому есть ряд ограничений. Однако, не все так плохо, как может показаться на первый взгляд, и вот почему.
\nДело в том, что все приложения для Windows Phone 7 (исключая системные) работают в рамках управляемого кода. При этом разрабатывать приложения предлагается используя Silverlight или XNA. Вот как выглядит схематическое обобщенное представление платформы Windows Phone 7.
\n\n\n\n![\"Совместимость](\"https://blog.zwezdin.com/2010/windows-phone-classic-compatibility/c0201ef0/1@2x.png\")
\n\n\n\n\nВесь управляемый код по-прежнему работает в рамках старого и доброго .NET Compact Framework. Да, это не точная копия .NET Compact Framework 2.0 или 3.5, но суть от этого не изменяется. Если мы попробуем глубже взглянуть на среду исполнения, то увидим следующую картинку.
\n\n\n\n![\"Совместимость](\"https://blog.zwezdin.com/2010/windows-phone-classic-compatibility/ca539d3f/2@2x.png\")
\n\n\n\n\nЧто следует из этой схемы? А следует несколько интересных выводов. Во-первых, видно, что все управляемые приложения могут использовать стандартную BCL (Base Class Library) и множество уже привычных нам объектов и пространств имен, например, таких как System.IO, System.Text, System.Threading и т.д. Дальше отчетливо видно, что и приложения XNA, и приложения Silverlight могут использовать эти объекты для своей работы, однако каждый из них имеет собственные объекты специфичные для каждого из вариантов. Эти объекты в большинстве случаев отвечают за построение пользовательского интерфейса или предназначены для сопутствующих задач. Ну и, наконец, видно, что есть несколько объектов “надстроек” над Silverlight и XNA, которые специфичны для телефона. Например, такие объекты позволяют получить доступ к камере или сенсорам, работать с радио или вызывать системные окна и т.д.
Если говорить о совместимости приложений, то такой подход позволяет нам безболезненно портировать часть приложения для Windows Phone Classic на новую платформу, если оно написано на управляемом коде. Портировать только часть приложения мы сможем из-за того, что среди представленных объектов нет Windows Forms. Это означает, что функциональность, связанную с пользовательским интерфейсом придется все-таки переделать. Но переделать пользовательский интерфейс – это не значит переделать полностью все приложение!
\nТаким образом, если ваше приложение для Windows Phone Classic работает на управляемом коде, то большую часть логики вы скорее всего сможете перенести путем простого копирования кода в новое приложение.
\nКак известно, рассуждать проще, чем сделать на практике. Поэтому здесь я прервусь и попробую взять приложение Windows Phone Classic и перенести его на новую платформу. Поехали!
\nИтак, для того, чтобы нам перенести наше Windows Phone Classic приложение, нам нужно сначала его создать. Я не буду сейчас уделять внимание какой-либо сложной логике, а создам несложное приложение, вычисляющее тригонометрические функции. Для этого на форме я добавлю несколько элементов управления и задам для них обработчики. Выглядеть эта красота будет примерно так.
\n\n\n\n![\"Совместимость](\"https://blog.zwezdin.com/2010/windows-phone-classic-compatibility/f2576b88/3@2x.png\")
\n\n\n\n\nПозволю себе напомнить, что при добавлении элементов управления в дизайнер среда разработки автоматически генерирует код и помещает его в файл .designer.cs. Выглядит этот код примерно так:
namespace MyHardApplication\n{\n partial class Form1\n {\n /// <summary>\n /// Required designer variable.\n /// </summary>\n private System.ComponentModel.IContainer components = null;\n\n /// <summary>\n /// Clean up any resources being used.\n /// </summary>\n /// <param name=\"disposing\">true if managed resources should be disposed; otherwise, false.</param>\n protected override void Dispose(bool disposing)\n {\n if (disposing && (components != null))\n {\n components.Dispose();\n }\n base.Dispose(disposing);\n }\n\n #region Windows Form Designer generated code\n\n /// <summary>\n /// Required method for Designer support - do not modify\n /// the contents of this method with the code editor.\n /// </summary>\n private void InitializeComponent()\n {\n this.SinTextBox = new System.Windows.Forms.TextBox();\n this.SinButton = new System.Windows.Forms.Button();\n this.CosButton = new System.Windows.Forms.Button();\n this.CosTextBox = new System.Windows.Forms.TextBox();\n this.TanButton = new System.Windows.Forms.Button();\n this.TanTextBox = new System.Windows.Forms.TextBox();\n this.AtanButton = new System.Windows.Forms.Button();\n this.AtanTextBox = new System.Windows.Forms.TextBox();\n this.SuspendLayout();\n\n // Определение элементов управления\n\n //\n // SinTextBox\n //\n this.SinTextBox.Anchor = ((System.Windows.Forms.AnchorStyles)(((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Left)\n | System.Windows.Forms.AnchorStyles.Right)));\n this.SinTextBox.Location = new System.Drawing.Point(12, 16);\n this.SinTextBox.Name = \"SinTextBox\";\n this.SinTextBox.Size = new System.Drawing.Size(138, 21);\n this.SinTextBox.TabIndex = 0;\n\n // Аналогичное описание для остальных элементов управления\n\n //\n // Form1\n //\n this.AutoScaleDimensions = new System.Drawing.SizeF(96F, 96F);\n this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Dpi;\n this.AutoScroll = true;\n this.ClientSize = new System.Drawing.Size(240, 294);\n this.Controls.Add(this.AtanButton);\n this.Controls.Add(this.AtanTextBox);\n this.Controls.Add(this.TanButton);\n this.Controls.Add(this.TanTextBox);\n this.Controls.Add(this.CosButton);\n this.Controls.Add(this.CosTextBox);\n this.Controls.Add(this.SinButton);\n this.Controls.Add(this.SinTextBox);\n this.Name = \"Form1\";\n this.Text = \"Form1\";\n this.ResumeLayout(false);\n\n }\n\n #endregion\n\n private System.Windows.Forms.TextBox SinTextBox;\n private System.Windows.Forms.Button SinButton;\n private System.Windows.Forms.Button CosButton;\n private System.Windows.Forms.TextBox CosTextBox;\n private System.Windows.Forms.Button TanButton;\n private System.Windows.Forms.TextBox TanTextBox;\n private System.Windows.Forms.Button AtanButton;\n private System.Windows.Forms.TextBox AtanTextBox;\n }\n}Как видно, такое описание достаточно легко поддается прочтению и осмыслению и впоследствии может послужить основной для переноса пользовательского интерфейса. Но об этом позже.
\nКак я говорил, для кнопок мы создадим обработчики с минимальной логикой. В реальном приложении кода, конечно, будет больше, но суть от этого не меняется.
\npublic partial class Form1 : Form\n{\n public Form1()\n {\n InitializeComponent();\n }\n\n private void SinButton_Click(object sender, EventArgs e)\n {\n SinTextBox.Text = Math.Sin(double.Parse(SinTextBox.Text)).ToString();\n }\n\n private void CosButton_Click(object sender, EventArgs e)\n {\n CosTextBox.Text = Math.Cos(double.Parse(CosTextBox.Text)).ToString();\n }\n\n private void TanButton_Click(object sender, EventArgs e)\n {\n TanTextBox.Text = Math.Cos(double.Parse(TanTextBox.Text)).ToString();\n }\n\n private void AtanButton_Click(object sender, EventArgs e)\n {\n AtanTextBox.Text = Math.Cos(double.Parse(AtanTextBox.Text)).ToString();\n }\n}Итак, теперь у нас есть готовое работающее приложение для Windows Phone Classic. Давайте попробуем перенести его на Windows Phone 7.
\nПервое, что мы сделаем – попробуем преобразовать пользовательский интерфейс. Для этих целей уже сейчас доступны различные инструменты (например, WinForm2XAML). Они позволяют на основе готовой сборки приложения получить разметку XAML.
\n\n\n\n![\"Совместимость](\"https://blog.zwezdin.com/2010/windows-phone-classic-compatibility/323f4bb1/4@2x.png\")
\n\n\n\n\nНа выходе получим разметку, похожую на следующую.
\n<phoneNavigation:PhoneApplicationPage\n x:Class=\"MyHardApplication.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n\n <Canvas x:Name=\"cvsForm1\" Background=\"{StaticResource PhoneBackgroundBrush}\">\n <Button x:Name=\"AtanButton\" Width=\"144\" Height=\"20\" Canvas.Top=\"249\" Canvas.Left=\"307\" Content=\"Atan\"\n Click=\"AtanButton_Click\" />\n <TextBox x:Name=\"AtanTextBox\" Width=\"289\" Height=\"20\" Canvas.Top=\"249\" Canvas.Left=\"12\" Text=\"\" />\n <Button x:Name=\"TanButton\" Width=\"144\" Height=\"20\" Canvas.Top=\"171\" Canvas.Left=\"307\" Content=\"Tan\"\n Click=\"TanButton_Click\" />\n <TextBox x:Name=\"TanTextBox\" Width=\"289\" Height=\"20\" Canvas.Top=\"171\" Canvas.Left=\"12\" Text=\"\" />\n <Button x:Name=\"CosButton\" Width=\"144\" Height=\"20\" Canvas.Top=\"93\" Canvas.Left=\"307\" Content=\"Cos\"\n Click=\"CosButton_Click\" />\n <TextBox x:Name=\"CosTextBox\" Width=\"289\" Height=\"20\" Canvas.Top=\"93\" Canvas.Left=\"12\" Text=\"\" />\n <Button x:Name=\"SinButton\" Width=\"144\" Height=\"20\" Canvas.Top=\"16\" Canvas.Left=\"307\" Content=\"Sin\"\n Click=\"SinButton_Click\" />\n <TextBox x:Name=\"SinTextBox\" Width=\"289\" Height=\"20\" Canvas.Top=\"16\" Canvas.Left=\"12\" Text=\"\" />\n </Canvas>\n\n</phoneNavigation:PhoneApplicationPage>К сожалению, используемый мной инструмент для переноса не смог перенести обработчики, а также не совсем корректно обработал отступы. Но в целом результат получился неплохой.
\nНу и осталось только перенести код логики (простым копированием) и обработчиков.
\npublic partial class MainPage : PhoneApplicationPage\n{\n public MainPage()\n {\n InitializeComponent();\n\n SupportedOrientations = SupportedPageOrientation.Portrait | SupportedPageOrientation.Landscape;\n }\n\n private void SinButton_Click(object sender, RoutedEventArgs e)\n {\n SinTextBox.Text = Math.Sin(double.Parse(SinTextBox.Text)).ToString();\n }\n\n private void CosButton_Click(object sender, RoutedEventArgs e)\n {\n CosTextBox.Text = Math.Cos(double.Parse(CosTextBox.Text)).ToString();\n }\n\n private void TanButton_Click(object sender, RoutedEventArgs e)\n {\n TanTextBox.Text = Math.Tan(double.Parse(TanTextBox.Text)).ToString();\n }\n\n private void AtanButton_Click(object sender, RoutedEventArgs e)\n {\n AtanTextBox.Text = Math.Atan(double.Parse(AtanTextBox.Text)).ToString();\n }\n}Теперь можно запустить приложение и полюбоваться на результат.
\n\n\n\n![\"Совместимость](\"https://blog.zwezdin.com/2010/windows-phone-classic-compatibility/5c63af32/5@2x.png\")
\n\n\n\n\nТак мы перенесли небольшое приложение с Windows Phone Classic на Windows Phone 7 в несколько шагов.
\nВ этом примере я не старался показать, что перенести приложение на Windows Phone 7 можно в несколько кликов. Однако, я думаю теперь стало понятно, что процесс переноса приложений не такой уж и страшный, и некоторых ситуациях не нужно переписывать приложения полностью с чистого листа.
\nТем не менее, справедливости ради стоит отметить, что такой подход не работает в случае когда:
\nP/Invoke (в этом случае этот участок кода придется дорабатывать);Также стоит сказать, что библиотека .NET CF в WP7 покрывает не все объекты, которые были доступны в WP Classic. Поэтому при переносе логики также могут возникать ньюансы.
\nОднако, в целом видно, что платформы очень схожие и перенос своих приложений – не такое уж и тяжелое занятие.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-phone-classic-compatibility/6c4bac88/windows_phone-classic-compatibility@cover.png" }, { "id": "https://blog.zwezdin.com/2010/windows-phone-push-notifications-raw/", "url": "https://blog.zwezdin.com/2010/windows-phone-push-notifications-raw/", "title": "Push Notifications в Windows Phone 7 (raw)", "date_published": "2010-04-28T12:00:00.000Z", "content_html": "Я уже рассказывал о том, что представляют собой уведомления в Windows Phone 7. Используя этот механизм можно доставлять уведомление из сервиса в облаке непосредственно на мобильное устройство.
\nЯ не буду рассматривать устройство механизма уведомлений в целом (ознакомиться с ним можно здесь), повторю только отдельные типы уведомлений:
\nНа этот раз давайте поговорим о Raw Notifications.
\nRaw Notifications – это наиболее гибкий тип уведомлений. Обрабатывать данный тип уведомлений можно по своему усмотрению, используя нужный для приложения алгоритм. Если в случае с Toast Notifications и Tile Notifications мы должны соблюдать определенный формат и тип передаваемых данных (для Toast – строка, для Tile – адрес до изображения). то в случае с Raw Notifications мы можем передавать абсолютно любые данные, которые нам необходимы.
\nОсновная идея отправки уведомления остается той же самой – мобильное приложение подключается к сервису в облаке, получает уникальный URI и каким-либо образом передает его приложению, которое должно уведомлять наш сервис.
\nprivate HttpNotificationChannel notifications;\nprivate const string notificationServiceName = \"Some test\";\n\nprivate void InitializePushChannel()\n{\n if (notifications != null)\n {\n ShowUri(notifications.ChannelUri);\n }\n else\n {\n try\n {\n notifications = new HttpNotificationChannel(Application.Current.ToString(), notificationServiceName);\n notifications.ChannelUriUpdated += new EventHandler<NotificationChannelUriEventArgs>(notifications_ChannelUriUpdated);\n notifications.Open();\n ShowUri(notifications.ChannelUri);\n\n notifications.BindToShellNotification();\n }\n catch (NotificationChannelExistsException)\n {\n notifications = HttpNotificationChannel.Find(Application.Current.ToString());\n notifications.ChannelUriUpdated += new EventHandler<NotificationChannelUriEventArgs>(notifications_ChannelUriUpdated);\n ShowUri(notifications.ChannelUri);\n }\n }\n}Как видно, для работы с механизмом уведомлений используется все тот же объект HttpNotificationChannel. Аналогичным образом следует обрабатывать ситуацию, когда сервис уже был зарегистрирован (в этом случае следует использовать метод Find). Также следует обрабатывать событие ChannelUriUpdated на случай, если сервис в облаке решит изменить адрес для отправки уведомлений. Для этого мы создадим специальный обработчик, который в случае изменения адреса будет отображать его пользователю.
\nprivate void ShowUri(Uri uri)\n{\n if (uri != null)\n {\n Dispatcher.BeginInvoke(() => ChannelUri.Text = uri.ToString());\n Debug.WriteLine(uri.ToString());\n }\n}Для того, чтобы обработать данные, которые были получены с помощью Raw-уведомлений следует подписаться на событие HttpNotificationReceived. Это событие будет срабатывать всякий раз, когда поступает новое Raw-уведомление.
\nprivate HttpNotificationChannel notifications;\nprivate const string notificationServiceName = \"Some test\";\n\nprivate void InitializePushChannel()\n{\n if (notifications != null)\n {\n ShowUri(notifications.ChannelUri);\n }\n else\n {\n try\n {\n notifications = new HttpNotificationChannel(Application.Current.ToString(), notificationServiceName);\n notifications.ChannelUriUpdated += new EventHandler<NotificationChannelUriEventArgs>(notifications_ChannelUriUpdated);\n notifications.HttpNotificationReceived += new EventHandler<HttpNotificationEventArgs>(notifications_HttpNotificationReceived);\n notifications.Open();\n ShowUri(notifications.ChannelUri);\n\n notifications.BindToShellNotification();\n }\n catch (NotificationChannelExistsException)\n {\n notifications = HttpNotificationChannel.Find(Application.Current.ToString());\n notifications.ChannelUriUpdated += new EventHandler<NotificationChannelUriEventArgs>(notifications_ChannelUriUpdated);\n notifications.HttpNotificationReceived += new EventHandler<HttpNotificationEventArgs>(notifications_HttpNotificationReceived);\n ShowUri(notifications.ChannelUri);\n }\n }\n}Теперь создадим обработчик, который будет срабатывать в момент получения уведомлений. Для этого мы уже подписались на событие HttpNotificationReceived. В параметрах обработчика события передается объект HttpNotificationEventArgs, позволяющий получить доступ к телу HTTP-запроса, который был получен от приложения, создавшего уведомление. В простейшем случае давайте отобразим это сообщение пользователю. Тело сообщения доступно как поток (Stream). Для его чтения мы будем использовать объект StreamReader.
\nvoid notifications_HttpNotificationReceived(object sender, HttpNotificationEventArgs e)\n{\n using (var r = new StreamReader(e.Notification.Body))\n {\n var data = r.ReadToEnd();\n Debug.WriteLine(data);\n Dispatcher.BeginInvoke(() => ReceivedData.Text = data);\n }\n}В данном обработчике мы используем элемент управления ReceivedData. Для того, чтобы это стало возможным его необходимо добавить на форму. Сделаем это легким движением руки.
\n<phoneNavigation:PhoneApplicationPage\n x:Class=\"ToastNotification.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n\n <Grid x:Name=\"LayoutRoot\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n <Grid.Background>\n <ImageBrush ImageSource=\"FormBackground.jpg\" Stretch=\"UniformToFill\"/>\n </Grid.Background>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\" Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"Notifications\" x:Name=\"textBlockListTitle\" Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n <Border VerticalAlignment=\"Top\" HorizontalAlignment=\"Center\" Margin=\"20\" Padding=\"20\" CornerRadius=\"5\">\n <Border.Background>\n <SolidColorBrush Color=\"Black\" Opacity=\"0.2\"/>\n </Border.Background>\n <TextBlock Name=\"ReceivedData\"\n TextWrapping=\"Wrap\"\n FontSize=\"30\"/>\n </Border>\n\n <Border VerticalAlignment=\"Center\" HorizontalAlignment=\"Center\" Margin=\"20\" Padding=\"20\" CornerRadius=\"5\">\n <Border.Background>\n <SolidColorBrush Color=\"Black\" Opacity=\"0.2\"/>\n </Border.Background>\n <TextBlock Name=\"ChannelUri\"\n TextWrapping=\"Wrap\"\n FontSize=\"30\"/>\n </Border>\n\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>Мобильное приложение готово, теперь, используя полученный URI для отправки уведомлений отправить HTTP-запрос по этому адресу. Для этого как раньше создадим небольшое консольное приложение, способное выполнить эти несложные действия. Для этих целей мы все так же будем использовать объект WebClient. Однако, в отличие от Toast Notifications, при отправке Raw Notifications не нужно соблюдать какой-либо формат сообщения – можно просто записать в тело сообщения те данные, которые необходимо отправить мобильному устройству. Также стоит изменить заголовок “X-NotificationClass” на значение “3”, что будет означать наивысший приоритет отправки для Raw-уведомлений.
\nПри отправке уведомления, в ответ мы также получим два заголовка “X-DeviceConnectionStatus” и “X-NotificationStatus”, которые позволяют определить состояние подключения устройства к сети и статус доставки этого сообщения. Таким образом, код нашего простого приложения будет выглядеть следующим образом.
\nclass Program\n{\n private const string Url = @\"http://sn1.notify.live.net/throttledthirdparty/01.00/AAFTkavjFpAuT4i1fIKvueDiAgoOs1ADAgAAAAQOMDAwAAAAAAAAAAAAAAA\";\n\n static void Main(string[] args)\n {\n Console.Write(\"Text: \");\n string text = Console.ReadLine();\n SendToast(Url, text);\n Console.ReadLine();\n }\n\n static void SendToast(string uri, string text)\n {\n var client = new WebClient();\n\n client.Headers.Add(\"Content-Type\", \"text/html\");\n client.Headers.Add(\"X-NotificationClass\", \"3\");\n\n var result = client.UploadString(uri, \"POST\", text);\n Console.WriteLine(result);\n Console.WriteLine(\"Device status is {0}\", client.ResponseHeaders[\"X-DeviceConnectionStatus\"]);\n Console.WriteLine(\"Notification status is {0}\", client.ResponseHeaders[\"X-NotificationStatus\"]);\n }\n}Теперь при запуске приложения и отправке текста, этот текст будет отображен на экране мобильного устройства.
\n\n\n\n![\"Push](\"https://blog.zwezdin.com/2010/windows-phone-push-notifications-raw/c063c5c6/1@2x.png\")
\n\n\n\n\nМы создали с вами тривиальное приложение, которое получая строку просто отображает её на экране. Однако, вся мощь Raw Notifications состоит в том, что мы можем определить совершенно любое поведение для обработки уведомлений. Например, давайте изменим приложение так, чтобы при получении названий некоторых цветов оно изменяло цвет букв, отображающих сообщение уведомления.
\nvoid notifications_HttpNotificationReceived(object sender, HttpNotificationEventArgs e)\n{\n using (var r = new StreamReader(e.Notification.Body))\n {\n var data = r.ReadToEnd().Trim('\\0');\n Debug.WriteLine(data);\n\n switch (data)\n {\n case \"red\":\n Dispatcher.BeginInvoke(() => ReceivedData.Foreground = new SolidColorBrush(Colors.Red));\n break;\n case \"green\":\n Dispatcher.BeginInvoke(() => ReceivedData.Foreground = new SolidColorBrush(Colors.Green));\n break;\n case \"blue\":\n Dispatcher.BeginInvoke(() => ReceivedData.Foreground = new SolidColorBrush(Colors.Blue));\n break;\n case \"white\":\n Dispatcher.BeginInvoke(() => ReceivedData.Foreground = new SolidColorBrush(Colors.White));\n break;\n case \"black\":\n Dispatcher.BeginInvoke(() => ReceivedData.Foreground = new SolidColorBrush(Colors.Black));\n break;\n case \"yellow\":\n Dispatcher.BeginInvoke(() => ReceivedData.Foreground = new SolidColorBrush(Colors.Yellow));\n break;\n case \"orange\":\n Dispatcher.BeginInvoke(() => ReceivedData.Foreground = new SolidColorBrush(Colors.Orange));\n break;\n case \"gray\":\n Dispatcher.BeginInvoke(() => ReceivedData.Foreground = new SolidColorBrush(Colors.Gray));\n break;\n default:\n Dispatcher.BeginInvoke(() => ReceivedData.Text = data);\n break;\n }\n }\n}Теперь, при отправке уведомлений, содержащих имена цветов, цвет текста в приложении будет изменяться.
\n\n\n\n![\"Push](\"https://blog.zwezdin.com/2010/windows-phone-push-notifications-raw/b21f736a/2@2x.png\")
\n\n\n\n\nПонятно, что это тоже очень простой алгоритм обработки. Однако, он хорошо демонстрирует, что здесь никто не ограничивает нас тем, каким образом построить обработку уведомлений. В общем случае мы можем создавать совершенно любые типы манипуляций и изменять поведение приложения.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-phone-push-notifications-raw/3f02976a/windows_phone-push-notifications-raw@cover.png" }, { "id": "https://blog.zwezdin.com/2010/windows-phone-push-notifications-toast/", "url": "https://blog.zwezdin.com/2010/windows-phone-push-notifications-toast/", "title": "Push Notifications в Windows Phone 7 (toast)", "date_published": "2010-04-27T12:00:00.000Z", "content_html": "Рассматривая возможности Windows Phone 7 нельзя не обратить внимания на механизм Push Notification, которого не было в предыдущих версиях Windows Phone. Этот механизм сам по себе очень удобный для разработчиков и пользователей и позволяет асинхронно уведомлять пользователя о происходящих событиях. Например, сервис из облака может сообщить пользователю о том, что произошло какое-то событие, на которое нужно как-то отреагировать. Давайте разберемся как устроен этот механизм.
\nВ структуре Push Notifications существует специальный сервис в облаке (размещенный за счет мощностей Microsoft), который делает возможность работы уведомлений. Когда устройство хочет получать уведомления от обращается к этому сервису и устанавливает с ним постоянное соединение. В ответ на это сервис выдает этому устройству уникальный URI, используя который можно отправить по протоколу HTTP некоторое сообщение. Это сообщение получает тот самый сервис в облаке и пересылает его соответствующему устройству. Логично, что для каждого устройства и приложения этот URI будет уникальный. Таким образом, работу уведомлений в Windows Phone 7 можно описать так:
\nСхематически этот алгоритм можно изобразить следующим образом.
\n\n\n\n![\"Push](\"https://blog.zwezdin.com/2010/windows-phone-push-notifications-toast/8203f338/1@2x.png\")
\n\n\n\n\nСуществуют три разных вида уведомлений для Windows Phone 7:
\nВпоследствии я расскажу о каждом из типов уведомлений. В этот раз дайте поподробнее рассмотрим Toast Notifications. Как я уже говорил, этот тип уведомлений позволяет вывести небольшое сообщение на экран пользователя даже в тех случаях, когда само приложение неактивно. При нажатии на такое уведомление, приложение будет активировано. Давайте создадим приложение, использующее этот тип уведомлений.
\nДля начала создадим новое приложение Windows Phone 7 и добавим на форму элемент управления, который будет отображать текущий адрес для отправки уведомлений.
\n<phoneNavigation:PhoneApplicationPage\n x:Class=\"ToastNotification.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n\n <Grid x:Name=\"LayoutRoot\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n <Grid.Background>\n <ImageBrush ImageSource=\"FormBackground.jpg\" Stretch=\"UniformToFill\"/>\n </Grid.Background>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\" Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"Notifications\" x:Name=\"textBlockListTitle\" Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n\n <Border VerticalAlignment=\"Center\" HorizontalAlignment=\"Center\" Margin=\"20\" Padding=\"20\" CornerRadius=\"5\">\n <Border.Background>\n <SolidColorBrush Color=\"Black\" Opacity=\"0.2\"/>\n </Border.Background>\n <TextBlock Name=\"ChannelUri\"\n TextWrapping=\"Wrap\"\n FontSize=\"30\"/>\n </Border>\n\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>Теперь при старте приложения следует соединиться с сервисом уведомлений и получить адрес для отправки уведомлений. Для этих целей следует подключить сборку Microsoft.Phone.Notification и использовать объект HttpNotificationChannel. Если мы еще не обращались к сервису уведомлений, то необходимо использовать метод Open() и установить соединение; если ранее мы уже обращались к сервису, то нужно просто заново соединиться с сервисом, используя метод Find(). При установлении соединения мы должны указать уникальное имя канала и/или сервиса. Эти параметры задаются в конструкторе объекта HttpNotificationChannel.
После установления соединения мы можем обратиться к свойству ChannelUri объекта HttpNotificationChannel и получить текущий адрес для уведомлений. Однако, сервис уведомлений может самостоятельно изменить этот адрес по своему усмотрению. Для того, чтобы быть в курсе таких изменений следует подписаться на событие ChannelUriUpdated объекта HttpNotificationChannel и обрабатывать изменения адреса там.
После запуска приложения выведем текущий адрес для уведомлений на экран, а также в консоль отладки (чтобы этот адрес можно было скопировать в буфер обмена). Таким образом мы получим небольшой фрагмент кода для приложения Windows Phone 7.
\npublic partial class MainPage : PhoneApplicationPage\n{\n private HttpNotificationChannel notifications;\n private const string notificationServiceName = \"Some test\";\n\n public MainPage()\n {\n InitializeComponent();\n\n SupportedOrientations = SupportedPageOrientation.Portrait | SupportedPageOrientation.Landscape;\n\n InitializePushChannel();\n }\n\n private void InitializePushChannel()\n {\n if (notifications != null)\n {\n ShowUri(notifications.ChannelUri);\n }\n else\n {\n try\n {\n notifications = new HttpNotificationChannel(Application.Current.ToString(), notificationServiceName);\n notifications.ChannelUriUpdated += new EventHandler<NotificationChannelUriEventArgs>(notifications_ChannelUriUpdated);\n notifications.Open();\n ShowUri(notifications.ChannelUri);\n\n notifications.BindToShellNotification();\n }\n catch (NotificationChannelExistsException)\n {\n notifications = HttpNotificationChannel.Find(Application.Current.ToString());\n notifications.ChannelUriUpdated += new EventHandler<NotificationChannelUriEventArgs>(notifications_ChannelUriUpdated);\n ShowUri(notifications.ChannelUri);\n }\n }\n }\n\n private void ShowUri(Uri uri)\n {\n if (uri != null)\n {\n Dispatcher.BeginInvoke(() => ChannelUri.Text = uri.ToString());\n Debug.WriteLine(uri.ToString());\n }\n }\n\n private void notifications_ChannelUriUpdated(object sender, NotificationChannelUriEventArgs e)\n {\n ShowUri(e.ChannelUri);\n }\n}На этом создание приложения для устройства завершено. Теперь нам необходимо отправить специальное HTTP-сообщение по адресу для уведомлений. Для этих целей можно использовать различные сторонние утилиты, например, Fiddler. Однако, давайте пройдем путь до конца и создадим приложение, которое будет отправлять соответствующие уведомления по указанному адресу.
\nДля того, чтобы отправить Toast-уведомление следует использовать следующий формат сообщения:
\nX-WindowsPhone-Target: toast\n\n<?xml version=\"\"1.0\"\" encoding=\"\"utf-8\"\"?>\n<wp:PushNotification xmlns:wp=\"\"WindowsPhonePushNotification\"\">\n <wp:Toast>\n <wp:Text1>Header</wp:Text1>\n <wp:Text2>Text</wp:Text2>\n </wp:Toast>\n</wp:PushNotification>В данном случае Header и Text – это те значения, которые пользователь увидит у себя на экране. Кроме того, HTTP-сообщение должно иметь заголовок X-NotificationClass, которое отражает важность доставляемого сообщения. Более подробно о формате сообщений и классе важности сообщений можно почитать здесь и здесь.
В ответ на отправляемый HTTP-запрос сервис вернет ответ, в котором содержится два важных HTTP-заголовка — X-DeviceConnectionStatus и X-NotificationStatus. Заголовок X-DeviceConnectionStatus отражает состояние подключения устройства к сервису, а заголовок X-NotificationStatus позволяет понять успешно ли доставлено сообщение.
Теперь, все, что осталось сделать – это отправить соответствующий HTTP-запрос по указанному адресу и обработать результат. Сделаем небольшое консольное приложение в которое поместим следующий код.
\nclass Program\n{\n private const string Url = @\"http://sn1.notify.live.net/throttledthirdparty/01.00/AAFTkavjFpAuT4i1fIKvueDiAgoOs1ADAgAAAAQOMDAwAAAAAAAAAAAAAAA\";\n\n static void Main(string[] args)\n {\n Console.Write(\"Header: \");\n string header = Console.ReadLine();\n Console.Write(\"Text: \");\n string text = Console.ReadLine();\n SendToast(Url, header, text);\n Console.ReadLine();\n }\n\n static void SendToast(string uri, string header, string text)\n {\n var client = new WebClient();\n\n client.Headers.Add(\"Content-Type\", \"text/html\");\n client.Headers.Add(\"X-NotificationClass\", \"2\");\n\n var message = \"X-WindowsPhone-Target: toast\" + Environment.NewLine + Environment.NewLine +\n @\"<?xml version=\"\"1.0\"\" encoding=\"\"utf-8\"\"?>\n <wp:PushNotification xmlns:wp=\"\"WindowsPhonePushNotification\"\">\n <wp:Toast>\n <wp:Text1>{0}</wp:Text1>\n <wp:Text2>{1}</wp:Text2>\n </wp:Toast>\n </wp:PushNotification>\";\n\n\n\n var result = client.UploadString(uri, \"POST\", String.Format(message, header, text));\n Console.WriteLine(result);\n Console.WriteLine(\"Device status is {0}\", client.ResponseHeaders[\"X-DeviceConnectionStatus\"]);\n Console.WriteLine(\"Notification status is {0}\", client.ResponseHeaders[\"X-NotificationStatus\"]);\n }\n}Теперь при запуске мобильного приложения из консоли отладки получим нужный URI для отправки уведомлений и вставим его в полученное консольное приложение. При запуске консольного приложения укажем значения Header и Text. Если все прошло успешно, в ответ на этот запрос увидим сообщение о доставке уведомления.
![\"Push](\"https://blog.zwezdin.com/2010/windows-phone-push-notifications-toast/d0e57a0f/2@2x.png\")
\n\n\n\n\nЕсли теперь взглянуть на экран эмулятора Windows Phone 7, то можно увидеть, что там появилось соответствующее уведомление.
\n\n\n\n![\"Push](\"https://blog.zwezdin.com/2010/windows-phone-push-notifications-toast/da9dec7e/3@2x.png\")
\n\n\n\n\nОбратите внимание, что вместе с сообщением отображается некий значок. Это – значок приложения, который можно легко изменить.
\nКак видно, создать свое приложение, использующее уведомления очень просто. Ну а в следующий раз я расскажу о том, как использовать Raw Notifications.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-phone-push-notifications-toast/c093c029/windows_phone-push-notifications-toast@cover.png" }, { "id": "https://blog.zwezdin.com/2010/windows-phone-appbar/", "url": "https://blog.zwezdin.com/2010/windows-phone-appbar/", "title": "Меню и Application Bar для приложений Windows Phone 7", "date_published": "2010-04-26T12:00:00.000Z", "content_html": "Меню и панель инструментов являются неотъемлемыми частями для практически любого современного приложения. Эти элементы могут видоизменяться (например, превращаясь в ленту), но основной смысл всегда остается один – дать пользователю возможность перемещаться от одной функции приложения к другой.
\nНе обошлось без подобных элементов и в Windows Phone 7 – здесь появились два специфичных элемента, объединенных общим названием Application Bar. Элемент Application Bar позволяет разместить одновременно до 7 кнопок управления, а также добавить меню, которое вызывается пользователем по требованию. Application Bar всегда размещается в нижней части окна (если используется вертикальное расположение) или располагается слева или справа (если используется горизонтальное расположение). Приложение, использующее Application Bar выглядит следующим образом.
\n\n\n\n![\"Меню](\"https://blog.zwezdin.com/2010/windows-phone-appbar/fa590fb4/1@2x.png\")
\n\n\n\n\nИспользуя Application Bar приложения могут получить стандартизованное представление элементов навигации в приложении. При этом за разработчика уже будут решены стандартные вопросы, связанные с адаптацией внешнего вида под различные расположения и размеры экранов и т.д.
\nДля того, чтобы создать приложение с Application Bar следует выполнить несколько несложных шагов.
\nВо-первых, нужно добавить ссылку на сборку Microsoft.Phone.Shell (судя по всему в финальном выпуске название может быть переименовано). Эта сборка содержит все необходимые объекты для работы с Application Bar.
Во-вторых следует определить пространство имен в разметке страницы, которое соотносится с этими объектами. Назовем это пространство имено shell.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"AppBar.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n\n<!-- Содержимое окна -->\n\n</phoneNavigation:PhoneApplicationPage>Каждый объект PhoneApplicationPage содержит свойство ApplicationBar. Нужно проинициализировать это свойство для того, чтобы иметь возможность работать с Application Bar. Сделать это можно двумя способами – в разметке и программно. Если определить это свойство в разметке, то код страницы будет выглядеть следующим образом.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"AppBar.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n <phoneNavigation:PhoneApplicationPage.ApplicationBar>\n <shell:ApplicationBar Visible=\"True\" IsMenuEnabled=\"True\" Opacity=\"1.0\">\n </shell:ApplicationBar>\n </phoneNavigation:PhoneApplicationPage.ApplicationBar>\n\n<!-- Содержимое окна -->\n\n</phoneNavigation:PhoneApplicationPage>Как видно, используя различные свойства объекта AppliationBar можно управлять поведением нашей панели. Например, можно включить или отключить меню, задать режимы видимости и т.д. Для того, чтобы задать набор кнопок, которые будут располагаться на ApplicationBar следует добавить их в коллекцию Buttons. Каждая кнопка представляется объектом ApplicationBarIconButton, который также находится в сборке Microsoft.Phone.Shell.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"AppBar.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n <phoneNavigation:PhoneApplicationPage.ApplicationBar>\n <shell:ApplicationBar Visible=\"True\" IsMenuEnabled=\"True\" Opacity=\"1.0\">\n <shell:ApplicationBar.Buttons>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon1.png\"/>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon2.png\"/>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon3.png\"/>\n </shell:ApplicationBar.Buttons>\n </shell:ApplicationBar>\n </phoneNavigation:PhoneApplicationPage.ApplicationBar>\n\n<!-- Содержимое окна -->\n\n</phoneNavigation:PhoneApplicationPage>Как видно, при добавлении кнопки указывается путь до изображения с иконкой. Для того, чтобы иконка отображалась в приложении следует создать соответствующую папку в проекте, добавить туда нужные файлы и выставить для этих файлов следующие параметры:
\nContentAlwaysТеперь при запуске приложения на форме появится Application Bar с несколькими кнопками.
\nАналогичным образом определяется меню приложения. Однако, в этом случае следует использовать объекты ApplicationBarMenuItem и добавлять их в коллекцию MenuItems.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"AppBar.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n <phoneNavigation:PhoneApplicationPage.ApplicationBar>\n <shell:ApplicationBar Visible=\"True\" IsMenuEnabled=\"True\" Opacity=\"1.0\">\n <shell:ApplicationBar.Buttons>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon1.png\"/>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon2.png\"/>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon3.png\"/>\n </shell:ApplicationBar.Buttons>\n <shell:ApplicationBar.MenuItems>\n <shell:ApplicationBarMenuItem Text=\"About\"/>\n <shell:ApplicationBarMenuItem Text=\"Settings\"/>\n <shell:ApplicationBarMenuItem Text=\"Close\"/>\n </shell:ApplicationBar.MenuItems>\n </shell:ApplicationBar>\n </phoneNavigation:PhoneApplicationPage.ApplicationBar>\n\n<!-- Содержимое окна -->\n\n</phoneNavigation:PhoneApplicationPage>Теперь при запуске приложения панель будет отображаться, меню будет доступно, но при нажатии на каждый пункт ничего не будет происходить. Нужно добавить обработчик нажатия на кнопки и пункты меню. Делается это очень просто, стандартным для XAML способом.
\n<phoneNavigation:PhoneApplicationPage\n x:Class=\"AppBar.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n <phoneNavigation:PhoneApplicationPage.ApplicationBar>\n <shell:ApplicationBar Visible=\"True\" IsMenuEnabled=\"True\" Opacity=\"1.0\">\n <shell:ApplicationBar.Buttons>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon1.png\" Click=\"ApplicationBarIconButton_Click\"/>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon2.png\" Click=\"ApplicationBarIconButton_Click\"/>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon3.png\" Click=\"ApplicationBarIconButton_Click\"/>\n </shell:ApplicationBar.Buttons>\n <shell:ApplicationBar.MenuItems>\n <shell:ApplicationBarMenuItem Text=\"About\" Click=\"ApplicationBarMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Settings\" Click=\"ApplicationBarMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Close\" Click=\"ApplicationBarMenuItem_Click\"/>\n </shell:ApplicationBar.MenuItems>\n </shell:ApplicationBar>\n </phoneNavigation:PhoneApplicationPage.ApplicationBar>\n\n<!-- Содержимое окна -->\n\n</phoneNavigation:PhoneApplicationPage>Ну и осталось добавить обработчики в коде. В данном случае я буду просто выводить сообщение на экран.
\nprivate void ApplicationBarIconButton_Click(object sender, EventArgs e)\n{\n MessageBox.Show(\"Button clicked.\");\n}\n\nprivate void ApplicationBarMenuItem_Click(object sender, EventArgs e)\n{\n MessageBox.Show(\"Menu clicked\");\n}В данном случае я задал один и тот же обработчик для всех кнопок и для всех пунктов меню. Понятно, что в вашем приложении можно создать и определить несколько разных обработчиков, в каждом из которых определить собственное поведение.
\nТакже функциональность Application Bar позволяет немного переопределить внешний вид. Можно использовать свойство Opacity для изменения прозрачности панели. Если значение Opacity равно 1, то панель непрозрачна, при этом нижняя часть окна соприкасается с панелью Application Bar. Если значение свойства Opacity меньше 1, то окно растягивается по всей ширине, а панель располагается поверх окна. При этом, если установить значение свойства Opacity равным 0.01, то панель станет прозрачной и будет располагаться над окном. Определим 50% полупрозрачность панели и посмотрим как это будет выглядеть для пользователя. Для того, чтобы разница была заметна, разместим на фоне некоторое изображение.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"AppBar.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n xmlns:shell=\"clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone.Shell\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n <phoneNavigation:PhoneApplicationPage.ApplicationBar>\n <shell:ApplicationBar Visible=\"True\" IsMenuEnabled=\"True\" Opacity=\"0.5\">\n <shell:ApplicationBar.Buttons>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon1.png\" Click=\"ApplicationBarIconButton_Click\"/>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon2.png\" Click=\"ApplicationBarIconButton_Click\"/>\n <shell:ApplicationBarIconButton IconUri=\"/Images/icon3.png\" Click=\"ApplicationBarIconButton_Click\"/>\n </shell:ApplicationBar.Buttons>\n <shell:ApplicationBar.MenuItems>\n <shell:ApplicationBarMenuItem Text=\"About\" Click=\"ApplicationBarMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Settings\" Click=\"ApplicationBarMenuItem_Click\"/>\n <shell:ApplicationBarMenuItem Text=\"Close\" Click=\"ApplicationBarMenuItem_Click\"/>\n </shell:ApplicationBar.MenuItems>\n </shell:ApplicationBar>\n </phoneNavigation:PhoneApplicationPage.ApplicationBar>\n\n <Grid x:Name=\"LayoutRoot\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n <Grid.Background>\n <ImageBrush ImageSource=\"Images/landscape.jpg\" />\n </Grid.Background>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\" Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"page title\" x:Name=\"textBlockListTitle\" Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>Теперь при запуске приложения можно увидеть следующий результат.
\n\n\n\n![\"Меню](\"https://blog.zwezdin.com/2010/windows-phone-appbar/4726854d/2@2x.png\")
\n\n\n\n\nВсе аналогичные манипуляции с Application Bar можно выполнять и программно. Для этого следует воспользоваться теми же самыми объектами и свойством формы ApplicationBar.
Активные пользователи мобильных устройств очень хорошо знают, что одной из главных проблем при использовании устройства является ввод информации. Для ввода информации используется реальная или виртуальная клавиатуры. Более того, зачастую используется именно привычная QWERTY-раскладка клавиатуры. Проблема заключается в размерах.
\n\n\n\n![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/e05ed2a0/1@2x.png\")
\n\n\n\n\nФизические размеры устройств достаточно малы и разместить на экране таких аппаратов несколько десятков кнопок достаточно сложно, если оставлять кнопки большого размера. Поэтому зачастую кнопки остаются небольшими и ввод информации не такой удобный, как на настольных компьютерах или ноутбуках. С аппаратной выдвижной клавиатурой работать более удобно, но упомянутая выше проблема сохраняется – размеры кнопок невелики. Поэтому ввод информации при использовании мобильных устройств – одна из наиболее сложных проблем в удобстве пользования этих устройств.
\nОднако, недостаток в виде небольших размеров одновременно является и преимуществом данного вида устройств. Именно благодаря небольшим размерам мы имеем возможность использовать эти устройства в тех случаях, когда использование, например, ноутбука невозможно. Например, бывает очень сложно достать ноутбук и просмотреть содержимое своего электронного ящика, когда гуляешь по супермаркету, однако, это вполне реально сделать при использовании мобильного устройства. Именно поэтому эта проблема будет жить еще долго в мобильных устройствах и разработчики вряд ли что-то с этим смогут поделать. На самом деле, кое-что разработчики все-таки могут сделать. А именно, сделать работу с виртуальной клавиатурой более удобной.
\nКаким образом мы, как разработчики мобильных приложений можем упростить жизнь пользователям? Некоторое время назад я писал о контекстно-зависимых приложениях. На самом деле тот же самый контекстно-зависимый подход мы можем использовать при вводе информации пользователем в мобильное устройство. Необходимо только понять, на какие условия необходимо реагировать.
\nЕсли рассмотреть наиболее типичные для пользователя сценарии, то можно понять, что в большинстве случаев они повторяются. Так, например, клавиатура обычно используется для ввода номера телефона, имени контакта, ввода текстовой информации (например, сообщения электронной почты или SMS), ввода адреса электронной почты, адреса веб-ресурса и т.д. Сейчас не так важно понять все сценарии, сколько важно понять, что они есть и они действительно зачастую повторяются. При этом в каждом конкретном случае от клавиатуры необходима разная функциональность. Например, при вводе адреса электронной почты нам наверняка потребуются знаки @ и точка, а при вводе телефонного номера скорее всего нужны будут только цифры. Все эти варианты специфичны для каждого случая.
Мы плавно подошли к тому, что приложение способно помочь пользователю с вводом информации, адаптируя вид виртуальной клавиатуры в соответствии с его потребностями. Основная проблема в том, как определить что пользователь собирается вводить в данный момент. Если попробовать решить эту задачу в общем, то операционная система может только в ряде случае с трудом догадаться какую именно информацию собирается вводить пользователь. Поэтому, если бы проблема решалась именно таким образом, то вряд ли бы можно было рассчитывать на что-то эффективное.
\nДавайте посмотрим на это с другой стороны. Каждый разработчик при разработке своего приложения с большой вероятностью может знать для чего предназначено то или иное поле. Другими словами, когда разработчик размещает на форме очередное поле ввода, он, скорее всего, точно представляет для чего оно нужно и какая информация там будет. Поэтому наиболее правильным способом является дать разработчику приложения возможность определить поведение виртуальной клавиатуры для каждого элемента управления. Такой подход, одной стороны не сильно затруднит разработчика, а другой – сильно упростит жизнь обычному пользователю. Именно такой подход используется в Windows Phone 7 для ввода информации. Для этих целей для элементов управления WIndows Phone 7 существует свойство InputScope. Давайте посмотрим как оно работает.
Для начала создадим пустое Windows Phone 7 приложение на основе Silverlight и добавим на форму поле ввода (TextBox).
<phoneNavigation:PhoneApplicationPage\n x:Class=\"InputScope.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n\n <Grid x:Name=\"LayoutRoot\" Background=\"{StaticResource PhoneBackgroundBrush}\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\"\n Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"page title\" x:Name=\"textBlockListTitle\"\n Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n <TextBox Height=\"31\" HorizontalAlignment=\"Left\"\n Margin=\"6,29,0,0\" Name=\"textBox1\" Text=\"TextBox\"\n VerticalAlignment=\"Top\" Width=\"446\" />\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>Как видно, это совершенно обычное приложение. При запуске этого приложения и переключения фокуса на поле ввода мы увидим стандартную виртуальную клавиатуру Windows Phone 7.
\n\n\n\n![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/0eb95de4/2@2x.png\")
\n\n\n\n\nДавайте теперь поработаем с полем ввода и определим, что это поле предназначено для ввода телефонного номера. Для этого определим свойство InpuScope для поля ввода, указав ему значение TelephoneNumber. Свойство InputScope принимает значения из перечисления InputScopeNameValue. Значение TelephoneNumber как раз является одним из значений перечисления InputScopeNameValue.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"InputScope.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n\n <Grid x:Name=\"LayoutRoot\" Background=\"{StaticResource PhoneBackgroundBrush}\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\"\n Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"page title\" x:Name=\"textBlockListTitle\"\n Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n <TextBox Height=\"31\" HorizontalAlignment=\"Left\"\n Margin=\"6,29,0,0\" Name=\"textBox1\" Text=\"TextBox\"\n VerticalAlignment=\"Top\" Width=\"446\" >\n <TextBox.InputScope>\n <InputScope Names=\"TelephoneNumber\" />\n </TextBox.InputScope>\n </TextBox>\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>При запуске приложения и установке фокуса на поле ввода мы также увидим виртуальную клавиатуру, но в этот раз она примет несколько иной вид.
\n\n\n\n![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/fd709fcc/3@2x.png\")
\n\n\n\n\nКак видно, добавлением одной строчки кода в разметке мы добились того, что виртуальная клавиатура существенно изменила свой внешний вид и функциональность. На самом деле перечисление InputScopeNameValue имеет несколько десятков всевозможных значений, которые изменяют функциональность виртуальной клавиатуры.
Для того, чтобы увидеть каждый случай можно, конечно, изменять это значение и перезапускать приложение; однако, мы воспользуемся другим способом. Для начала с помощью Reflection получим всевозможные значения этого перечисления. После этого для каждого значения перечисления создадим новое поле ввода и определим для него соответствующее значение свойства InputScope. Разметка формы при этом изменится следующим образом.
<phoneNavigation:PhoneApplicationPage\n x:Class=\"InputScope.MainPage\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:phoneNavigation=\"clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone.Controls.Navigation\"\n xmlns:d=\"http://schemas.microsoft.com/expression/blend/2008\"\n xmlns:mc=\"http://schemas.openxmlformats.org/markup-compatibility/2006\"\n mc:Ignorable=\"d\" d:DesignWidth=\"480\" d:DesignHeight=\"800\"\n FontFamily=\"{StaticResource PhoneFontFamilyNormal}\"\n FontSize=\"{StaticResource PhoneFontSizeNormal}\"\n Foreground=\"{StaticResource PhoneForegroundBrush}\">\n\n <Grid x:Name=\"LayoutRoot\" Background=\"{StaticResource PhoneBackgroundBrush}\">\n <Grid.RowDefinitions>\n <RowDefinition Height=\"Auto\"/>\n <RowDefinition Height=\"*\"/>\n </Grid.RowDefinitions>\n\n <!--TitleGrid is the name of the application and page title-->\n <Grid x:Name=\"TitleGrid\" Grid.Row=\"0\">\n <TextBlock Text=\"MY APPLICATION\" x:Name=\"textBlockPageTitle\"\n Style=\"{StaticResource PhoneTextPageTitle1Style}\"/>\n <TextBlock Text=\"page title\" x:Name=\"textBlockListTitle\"\n Style=\"{StaticResource PhoneTextPageTitle2Style}\"/>\n </Grid>\n\n <!--ContentGrid is empty. Place new content here-->\n <Grid x:Name=\"ContentGrid\" Grid.Row=\"1\">\n <ScrollViewer BorderThickness=\"0\" Height=\"280\" VerticalAlignment=\"Top\">\n <StackPanel x:Name=\"Elements\">\n <StackPanel.Resources>\n <Style TargetType=\"TextBox\">\n <Setter Property=\"Margin\" Value=\"10\"/>\n </Style>\n </StackPanel.Resources>\n </StackPanel>\n </ScrollViewer>\n </Grid>\n </Grid>\n\n</phoneNavigation:PhoneApplicationPage>При этом в момент создания и загрузки формы создадим следующий код. Здесь мы получаем все значения перечисления и для каждого значения создадим новое поле ввода и помещаем его на форму. При этом для каждого поля ввода задается текущее значение InputScope.
foreach (var inputName in typeof(InputScopeNameValue).\n GetFields(BindingFlags.Public | BindingFlags.Static).Select(t => t.Name))\n{\n InputScopeNameValue val = (InputScopeNameValue)(Enum.Parse(typeof(InputScopeNameValue), inputName, true));\n\n if (val > 0)\n {\n Elements.Children.Add(new TextBox()\n {\n Text = inputName,\n InputScope = new System.Windows.Input.InputScope\n {\n Names =\n {\n new InputScopeName()\n {\n NameValue = val\n }\n }\n }\n });\n }\n}При запуске приложения на форме будет созданы элементы управления. При установлении фокуса на каждое поле можно увидеть различные варианты виртуальной клавиатуры.
\n\n\n\n![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/b6a420ea/4@2x.png\")
\n\n\n\n\nНаиболее интересные варианты виртуальной клавиатуры:
\nUrl: адаптировано для ввода адреса интернет ресурса, характерно, что в нижней части есть кнопка для ввода домена (при нажатии и удержании можно увидеть другие домены) и кнопка перехода к ресурсу (справа снизу).
\n\n\n\n![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/2362140b/5@2x.png\")
\n\n\n\n\n\n\n\n ![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/dd0a96b7/6@2x.png\")
\n\n\n\n\nEmailSmtpAddress: адаптировано для ввода адреса электронной почты, характерно, что в нижней части вынесен символ @ и точка, а также есть отдельная кнопка для ввода домена.
![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/a15c8cda/7@2x.png\")
\n\n\n\n\nPersonalFullName: адаптировано для ввода имени.
\n\n\n\n![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/0ba91c2a/8@2x.png\")
\n\n\n\n\nPostalCode: адаптировано для ввода кода города, характерно, что по умолчанию используется раскладка для цифр и знаков, но можно переключить в режим ввода букв. Аналогичная раскладка используется и для других способов ввода, использующих цифры.
\n\n\n\n![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/4d5f0359/9@2x.png\")
\n\n\n\n\nTelephoneNumber: адаптировано для ввода номера телефона.
\n\n\n\n![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/21fc12e6/10@2x.png\")
\n\n\n\n\nText: адаптировано для ввода текста, характерно, что есть отдельная кнопка для ввода смайлов (которые зачастую используется в теле электронного письма или SMS).
\n\n\n\n![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/178623b4/11@2x.png\")
\n\n\n\n\n\n\n\n ![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/216c4e64/12@2x.png\")
\n\n\n\n\nChat: адаптировано для использования в чатах, аналогично предыдущему способу, но здесь используются графические смайлы.
\n\n\n\n![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/8fbfb018/13@2x.png\")
\n\n\n\n\n\n\n\n ![\"Ввод](\"https://blog.zwezdin.com/2010/windows-phone-input/1f8642bb/14@2x.png\")
\n\n\n\n\nКроме этих режимов, перечисление InputScopeNameValue содержит еще огромное количество значений. На данный момент для некоторых значений вид виртуальной клавиатуры совпадает. Как это будет выглядеть в финальной версии пока не понятно, но большое количество различных значений вызывает надежду на то, что различных режимов виртуальной клавиатуры будет еще больше.
Не так давно пришлось потратить немного времени на настройку удаленного доступа через Powershell. Мне такой подход кажется очень хорошей альтернативной Remote Desktop Services в ряде случаев (перезапустить сервис на удаленном хостинге VDS, сделать резервные копии, посмотреть состояние системы и т.д.).
\nВозможность создания удаленных сеансов Powershell появилась в версии 2. Для этого используется командлет Enter-PSSession/Invoke-Command. Однако, перед их использованием следует подготовить среду.
Что делаем на сервере:
\nШаг 1: Открываем консоль Powershell и разрешаем удаленные сессии командлетом Enable-PSRemoting с ключом Force.
Enable-PSRemoting -ForceШаг 2: Убеждаемся в том, что служба WinRM запущена.
\nStart-Service WinRMШаг 3: Настраиваем правила в брэндмауэре, чтобы входящие подключения были возможны.
\nНа компьютере, который будет использоваться как клиентский тоже необходимо выполнить несколько действий:
\nШаг 1: Разрешить подключение к удаленным узлам. Для доступа к любым узлам можно воспользоваться следующей конструкцией:
\nSet-Item wsman:\\localhost\\client\\trustedhosts * -ForceШаг 2: Убедиться, что брэндмауэр не блокирует исходящие соединения.
\nТеперь для подключения к удаленному узлу через Powershell можно осуществлять так:
\nEnter-PSSession 192.168.1.160 -Credential VMNAME\\UserЗначения 192.168.1.160 и VMNAME\\User необходимо заменить адресом удаленного узла и именем пользователя Windows на сервере.
Теперь удаленный доступ через Powershell работает. Однако, есть еще один ньюанс. Возможно, кто-либо из вас пользуется профилями в Powershell. Профили – это специальные скрипты, которые запускаются при запуске самой консоли. Здесь, например, можно определить все необходимые алиасы и выполнить предварительные действия.
\nПроблема заключается в том, что профили не запускаются при использовании удаленных сеансов. Решить это можно путем использования разных конфигураций подключения. Для этого первоначально необходимо зарегистрировать конфигурацию на удаленном сервере. Сделать это можно путем выполнения коммандлета Register-PSSessionConfiguration. При этом каждой конфигурации присваивается имя. Для каждой конфигурации можно задать путь до скрипта, который будет выполняться при старте сессии.
Register-PSSessionConfiguration -name Config1 -startupScript c:\\scripts\\Startup.ps1После этого, при подключении к удаленному узлу, при использовании коммандлета Enter-PSSession следует указать имя конфигурации.
Enter-PSSession 192.168.1.160 -ConfigurationName Config1 -Credential VMNAME\\UserТеперь можно не тратить ресурсы сервера на создание сессии подключения через Remote Desktop Services и удаленно управлять сервером, используя Powershell.
", "tags": [ "Powershell" ], "banner_image": "https://blog.zwezdin.com/2010/powershell-remote-session/d15d7dfc/powershell_remote-session@cover.jpg" }, { "id": "https://blog.zwezdin.com/2010/windows-mobile-context-menu/", "url": "https://blog.zwezdin.com/2010/windows-mobile-context-menu/", "title": "Всплывающее меню для Windows Phone Classic", "date_published": "2010-04-17T12:00:00.000Z", "content_html": "Все мы видели контекстные меню в Windows Mobile. Несмотря на то, что они более-менее функциональные, работать с ними зачастую не очень удобно. В то же время общие тренды говорят о том, что всплывающее меню должно занимать весь экран и позволять работать пальцами. Такие меню уже есть в других мобильных платформах (например, Android). В Windows Phone 7 также реализуются крупные меню для приложений. Давайте попробуем сделать удобное с точки зрения использование контекстное меню для Windows Phone Classic. Для того, чтобы было понятно что именно мы будем делать в этой статье, я приведу несколько снимков экранов того, что должно получиться в результате.
\n\n\n\n![\"Всплывающее](\"https://blog.zwezdin.com/2010/windows-mobile-context-menu/d92ea2ec/1@2x.png\")
\n\n\n\n\n\n\n\n ![\"Всплывающее](\"https://blog.zwezdin.com/2010/windows-mobile-context-menu/18c45a5e/2@2x.png\")
\n\n\n\n\n\n\n\n ![\"Всплывающее](\"https://blog.zwezdin.com/2010/windows-mobile-context-menu/96f5785b/3@2x.png\")
\n\n\n\n\n\n\n\n ![\"Всплывающее](\"https://blog.zwezdin.com/2010/windows-mobile-context-menu/63592def/4@2x.png\")
\n\n\n\n\nТ.о. при отображении меню общий фон затемняется и поверх него появляется всплывающее меню с ориентированными под палец кнопками. Давайте попробуем сделать такую реализацию.
\nДля достижения поставленной цели мы будем придерживаться следующего порядка действий:
\nКак видим, последовательность действий простая. Понятно, что затемнение фона в данном случае – это только иллюзия (например, если будет изменяться время, то в «затемненном» варианте оно не изменится), но это работает достаточно успешно.
\nИтак, приступим. Для реализации описанной логики создадим новый класс, унаследованный от базового класса Form. Этот класс будет реализовывать всю логику нового всплывающего меню. Реализуем в этом объекте также интерфейс IDisposable (поскольку дочерние элементы Bitmap, которые нам пригодятся требует освобождения памяти).
public class PopupForm : Form, IDisposable\n{\n // ..\n}Для того, чтобы передать в форму информацию о кнопках создадим объект, описывающий эту кнопку. Пусть этот объект содержит название и заголовок кнопки, значок (если необходимо) и состояние (включен/выключен). Тогда описание такой кнопки будет очень простым.
\npublic class ButtonDescription\n{\n public ButtonDescription()\n {\n Checked = false;\n CanBeChecked = false;\n Icon = null;\n }\n\n public string Name { get; set; }\n public string Title { get; set; }\n public bool CanBeChecked { get; set; }\n public bool Checked { get; set; }\n public Bitmap Icon { get; set; }\n}Теперь при создании нашего всплывающего меню в конструкторе передадим коллекцию таких кнопок и сохраним эту коллекцию в приватном поле. Также установим в конструкторе стиль окна.
\npublic PopupForm(ButtonDescription[] buttons)\n{\n WindowState = FormWindowState.Maximized;\n FormBorderStyle = FormBorderStyle.None;\n\n _buttons = buttons;\n}Следующим шагом необходимо получить снимок экрана и затемнить его. Для получения снимка воспользуемся функцией BitBlt из системной библиотеки coredll.dll. Для затемнения изображения воспользуемся функцией AlphaBlend из той же библиотеки. Я не буду подробно рассматривать последовательность действий для этого шага. Всю последовательность действий иллюстрирует метод, код которого приведен ниже.
[DllImport(\"coredll.dll\")]\nextern public static Int32 AlphaBlend(IntPtr hdcDest, Int32 xDest,\n Int32 yDest, Int32 cxDest, Int32 cyDest,\n IntPtr hdcSrc, Int32 xSrc, Int32 ySrc,\n Int32 cxSrc, Int32 cySrc,\n BlendFunction blendFunction);\n\n[DllImport(\"coredll.dll\")]\npublic static extern bool BitBlt(IntPtr hObject, int nXDest,\n int nYDest, int nWidth,\n int nHeight, IntPtr hObjSource, int nXSrc,\n int nYSrc, TernaryRasterOperations dwRop);\n\n\n[DllImport(\"coredll.dll\")]\npublic static extern IntPtr GetDC(IntPtr hwnd);\n\n[DllImport(\"coredll.dll\")]\npublic static extern int ReleaseDC(IntPtr hwnd, IntPtr hdc);\n\npublic static Bitmap GenerateSnapshot(byte alpha)\n{\n Rectangle rect = Screen.PrimaryScreen.Bounds;\n var result = new Bitmap(rect.Width, rect.Height);\n\n var deviceContext = PlatformAPIs.GetDC(IntPtr.Zero);\n\n try\n {\n using (Graphics resultGx = Graphics.FromImage(result))\n {\n var screenHdc = deviceContext;\n var resultHdc = resultGx.GetHdc();\n\n PlatformAPIs.BitBlt(screenHdc, 0, 0,\n rect.Width, rect.Height, deviceContext, 0, 0,\n TernaryRasterOperations.SRCCOPY);\n\n if (alpha <= 255)\n {\n PlatformAPIs.AlphaBlend(resultHdc, 0, 0,\n result.Width, result.Height, screenHdc,\n rect.Left, rect.Top, rect.Width, rect.Height,\n new BlendFunction\n {\n BlendOp = 0,\n BlendFlags = 0,\n SourceConstantAlpha = alpha,\n AlphaFormat = 0\n });\n }\n\n resultGx.ReleaseHdc(resultHdc);\n }\n }\n finally\n {\n PlatformAPIs.ReleaseDC(IntPtr.Zero, deviceContext);\n }\n\n return result;\n}Теперь у нас есть метод, который делает снимок экрана и затемняет его. При отображении формы получим это изображение и сохраним его в закрытом поле. Для этого переопределим методы Show и ShowDialog формы, а также создадим метод ShowMenu, который будет возвращать имя выбранной кнопки.
private Image _formSnapshot;\n\npublic new void Show()\n{\n ShowMenu();\n}\n\npublic new void ShowDialog()\n{\n ShowMenu();\n}\n\npublic string ShowMenu()\n{\n UpdateBackground(PlatformAPIs.GenerateSnapshot(true));\n\n // ...\n}\n\nprivate void UpdateBackground(Image formSnapshot)\n{\n if (_formSnapshot != null)\n {\n _formSnapshot.Dispose();\n }\n\n _formSnapshot = formSnapshot;\n\n // ...\n}Мы помним, что для отображения фона формы нам нужно затемненное изображение, поверх которого нарисован прямоугольник (для меню). Поэтому в момент заданий фона формы нарисуем этот прямоугольник и сохраним изображение фона.
\nprivate void UpdateBackground(Image formSnapshot)\n{\n // ..\n\n RefreshFormBackground();\n}\n\nprivate void RefreshFormBackground()\n{\n // удаляем старое изображение, если есть\n if (_backgroundImage != null)\n {\n _backgroundImage.Dispose();\n _backgroundImage = null;\n }\n\n\n // подсчитываем количество кнопок и размер экрана\n var itemsCount = _buttons.Length;\n var currentSize = Screen.PrimaryScreen.Bounds;\n\n // создаем чистое изображения для фона\n var backgroundImage = new Bitmap(currentSize.Width, currentSize.Height);\n\n // генерируем фон\n using (var backgroundImageGraphics = Graphics.FromImage(backgroundImage))\n {\n // наносим скриншот экрана, если есть\n if (_formSnapshot != null)\n {\n backgroundImageGraphics.DrawImage(_formSnapshot, 0, 0);\n }\n\n // наносим фон меню\n using (var menuBackgroundImage = GenerateMenuBackground(itemsCount,\n ItemWidth, ItemHeight, itemsCount))\n {\n backgroundImageGraphics.DrawImage(menuBackgroundImage,\n currentSize.Width / 2 - menuBackgroundImage.Width / 2,\n currentSize.Height / 2 - menuBackgroundImage.Height / 2);\n }\n }\n\n // сохраняем результат\n _backgroundImage = backgroundImage;\n}\n\nprivate static Bitmap GenerateMenuBackground(int itemsCount, int itemWidth,\n int itemHeight, int borderRadius)\n{\n // чистое изображение\n var result = new Bitmap(itemWidth, itemHeight * itemsCount);\n\n using (var gx = Graphics.FromImage(result))\n {\n // наносим прямоугольник со скругленными краям\n gx.DrawRoundedRectangle(Color.White, Color.White,\n new Rectangle(0, 0, itemWidth, itemHeight * itemsCount),\n new Size(borderRadius, borderRadius));\n\n // наносим разделители\n var dividerPen = new Pen(Color.Silver);\n\n for (int i = 1; i < itemsCount; i++)\n {\n gx.DrawLine(dividerPen, borderRadius, itemHeight * i,\n itemWidth - borderRadius, itemHeight * i);\n }\n }\n\n return result;\n}Как видно, мы используем метод DrawRoundedRectangle для генерации прямоугольника со скругленными краями. На самом деле это – метод расширения для класса Graphics, разработанный Алексом Яхниным в его библиотеке UI Framework. Теперь при отрисовке фона формы будем использовать заранее подготовленное изображение.
protected override void OnPaintBackground(PaintEventArgs e)\n{\n if (_backgroundImage != null)\n {\n e.Graphics.DrawImage(_backgroundImage, 0, 0);\n }\n else\n {\n base.OnPaintBackground(e);\n }\n}Теперь у нас есть форма, которая делает снимок экрана, затемняет его и выводит на экран форму с прямоугольником. Осталось только добавить кнопки на эту форму. Все кнопки у нас будут графическими. Поэтому стандартные кнопки нам не подходят (по вашему вкусу здесь вы можете добавить свои элементы управления). Для простоты создадим свои кнопки, которые имеют несколько изображений для разных состояний. Для этого создадим класс, унаследованный от элемента управления Control, который принимает в конструкторе текст и другие параметры и генерирует три изображения (обычное состояние, нажатое состояние, отмеченное состояние). Эти изображения будут использоваться в момент отрисовки элемента управления. Дальше обработам события OnMouseUp и OnMouseDown и будем переключать состояние, управляющее выбором одного из трех изображений. Я не буду приводить полный исходный код этого элемента управления (чтобы не загромождать пространство). При желании вы можете посмотреть его в приложенных исходных кодах.
Теперь когда у нас есть элемент управления для кнопки, рассчитаем размеры экрана и разместим на форме все эти элементы управления. При этом, если на форме были какие-то еще элементы управления, то удалим их.
\nprivate void RefreshButtonControls()\n{\n // очистка старых элементов управления\n var oldControls = Controls.OfType<IDisposable>().ToArray();\n Controls.Clear();\n foreach (IDisposable control in oldControls)\n {\n control.Dispose();\n }\n\n // создание элементов управления и размещение на форме\n var itemsCount = _buttons.Length;\n int dx = Screen.PrimaryScreen.Bounds.Width / 2\n - ItemWidth / 2;\n int dy = Screen.PrimaryScreen.Bounds.Height / 2\n - (ItemHeight * itemsCount) / 2;\n\n for (int i = 0; i < itemsCount; i++)\n {\n var buttonInfo = _buttons[i];\n var btn = new PopupButton(_buttons[i].Name, buttonInfo.Title,\n MenuFont, ItemWidth - 10, ItemHeight - 10,\n Color.Black, Color.White, PressedColor, CheckedColor,\n buttonInfo.CanBeChecked, buttonInfo.Checked,\n buttonInfo.Icon)\n { Left = dx + 5, Top = i * ItemHeight + 5 + dy };\n btn.Click += delegate(object sender, EventArgs e)\n {\n foreach (PopupButton control in\n Controls.OfType<PopupButton>())\n {\n if (control != sender)\n {\n control.IsChecked = false;\n\n }\n }\n\n // сохраняем результат\n Result = ((PopupButton)sender).Name;\n\n // закрываем форму\n Close();\n };\n Controls.Add(btn);\n }\n}Теперь у нас есть форма, которая в качестве фона имеет затемненный снимок экрана и отрисованный на ней прямоугольник, и содержит набор кнопок в качестве элементов управления контекстного меню. При нажатии на любой кнопке форма скрывается. Результат работы такого меню будет выглядеть следующим образом.
\n\n\n\n![\"Всплывающее](\"https://blog.zwezdin.com/2010/windows-mobile-context-menu/96f5785b/5@2x.png\")
\n\n\n\n\nТакими относительно несложными шагами мы добились создания эффектного контекстного меню, которое может успешно заменить стандартное контекстное меню. Понятно, что приведенный пример – это только небольшая демонстрация. При желании его можно усовершенствовать и добавить возможности листания, более сложные элементы управления, вложенности и т.д.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-mobile-context-menu/6e5feb1f/windows_mobile-context-menu@cover.png" }, { "id": "https://blog.zwezdin.com/2010/windows-mobile-background-services/", "url": "https://blog.zwezdin.com/2010/windows-mobile-background-services/", "title": "Фоновые службы в Windows Phone Classic", "date_published": "2010-04-14T12:00:00.000Z", "content_html": "Несмотря на то, что на рынке начинают появляться новые тренды в мобильных операционных системах (в т.ч. Windows Phone 7), предыдущие версии Windows Phone (WM 5.x, WM 6.x) остаются и еще долго будут оставаться актуальными операционными системами для многих пользователей и разработчиков. Поэтому на этот раз я бы хотел рассказать о том, как можно создавать свои собственные фоновые службы в Windows Phone Classic на основе .NET Compact Framework.
\nФоновая служба — это некоторое приложение, которое запускается при запуске операционной системы и остается работать в фоне на протяжении всей работы устройства. При этом фоновая служба не имеет какого-либо пользовательского интерфейса и не отображается в диспетчере задач.
\nК сожалению, .NET Compact Framework не содержит готовых механизмов по созданию подобных служб. При этом создавать фоновые службы можно используя только неуправляемый код. Ограничение состоит в том, что для управляемой среды просто не реализована эта функциональность. Однако, хорошая новость заключается в том, что энтузиасты Pavel Bánský и Peter Nowak создали собственную обертку для неуправляемых интерфейсов и поместили ее в специальную библиотеку с открытым исходным кодом — Managed Services for Windows Mobile. Эта библиотека позволяет создавать фоновые службы для Windows Phone Classic на основе управляемого кода в рамках .NET Compact Framework.
\nДавайте попробуем создать небольшое приложение, которое будет следить за поступлением новых SMS-сообщений и записывать в специальный журнал все моменты поступления нового сообщение.
\nПервое, что необходимо сделать – это создать новый проект и добавить ссылку на сборку ManagedService.dll. Поскольку приложение будет являться фоновой службой, то для него не нужен пользовательский интерфейс. Поэтому при создании проекта укажем, что необходимо создать консольное приложение.
\nПосле создания приложения следует создать новый класс и определить для него в качестве наследника класс ServiceApplicaiton (доступный в сборке ManagedService.dll). Этот класс, по сути, и будет являться фоновой службой. Необходимо чтобы в приложении был единственный экземпляр этого класса. Мы не будем использовать изощренные архитектурные конструкции и для простоты примера просто используем Singleton. Для этого определим закрытый конструктор и статическое поле для хранения созданного экземпляра этого класса.
public class BackgroundService : ServiceApplication\n{\n private static readonly BackgroundService _service =\n new BackgroundService();\n\n public static BackgroundService Service\n { get { return _service; } }\n\n private BackgroundService()\n {\n\n }\n}Прежде чем наш сервис начнет работать следует выполнить еще несколько важных действий в конструкторе:
\nЭти действия выполняются с помощью конструкций базового класса.
\nprivate BackgroundService()\n{\n ServiceGuid = new Guid(\"EA6E9740-4698-11DF-88EE-BF5256D89593\");\n ServiceName = \"SmsLogger\";\n RegisterService();\n}Последнее, что осталось сделать – это запускать данный сервис при запуске исполняемого файла. Для этого в методе Main следует получить экземпляр класса для этого сервиса и вызвать метод Start.
namespace SmsLogger\n{\n class Program\n {\n static void Main(string[] args)\n {\n BackgroundService.Service.Start();\n }\n }\n}Этого достаточно для того, чтобы наш сервис запустился и начал работать в фоновом режиме.
\nПосле успешного создания сервиса нужно определить для него какую-то логику (зачем нужен сервис, который ничего не делает?). Для этого в конструкторе можно инициировать новый поток, который будет выполнять какие-либо действия, либо подписаться на уведомления от системных событий, происходящих в системе. Чтобы слегка упростить пример воспользуемся вторым подходом и подпишемся на системное событие, уведомляющее о том, что изменилось количество непрочтенных SMS. Для этого добавим ссылки на две стандартные сборки – Microsoft.WindowsMobile и Microsoft.WindowsMobile.Status, после чего будем использовать объект SystemState для получения системных уведомлений. Для обработки уведомления сохраним объект SystemState в закрытом поле, подпишемся на событие изменения и создадим обработчик события.
private SystemState state =\n new SystemState(SystemProperty.MessagingSmsUnread);\n\nprivate BackgroundService()\n{\n // ...\n\n state.Changed += MessagingSmsUnreadStateChanged;\n}\n\nvoid MessagingSmsUnreadStateChanged(object sender,\n ChangeEventArgs args)\n{\n WriteLog(String.Format(\"Total unread sms is {0}\",\n args.NewValue));\n}Теперь, при изменении количества непрочтенных SMS будет срабатывать обработчик события. Как видно, в нем мы вызываем метод для записи информации в некоторый лог. Для того, чтобы проект запустился определим этот метод. Для простоты, пусть он записывает все события в файл, находящийся в корневой папке.
\nprivate static void WriteLog(string text)\n{\n using (var fs = new FileStream(@\"\\smslog.txt\", FileMode.Append))\n {\n using (var sw = new StreamWriter(fs))\n {\n sw.WriteLine(\"{0}: {1}\", DateTime.Now.ToString(), text);\n }\n }\n}Теперь, при запуске нашей службы и поступлении новых SMS на телефон, будет срабатывать обработчик и сохранять данные в системный лог.
\nПосле создания сервиса и определения логики следует указать операционной системе, что сервис необходимо запускать при старте приложения. По аналогии с настольной версией Windows, в Windows Phone автоматический запуск приложений осуществляется путем указания пути к приложению в соответствующей ветке реестра.
\nДля того, чтобы сервисом можно было управлять и отслеживать его состояние, в рамках проекта Managed Services for Windows Mobile было создано специальное приложение, которое управляет запуском сервисов. Идея приложения простая — при запуске оно само себя помещает в автозапуск. После этого оно сканирует ветку реестра HKEY_LOCAL_MACHINE\\Software\\ManagedServices и запускает все необходимые службы.
В это секции создаются секции (имя которой соответствует идентификатору службы), в которых указывается имя сервиса, путь для загрузки и другая информация.К счастью, базовый класс ServiceApplication уже содержит методы RegisterService и UnRegisterService, которые выполняют всю работу по регистрации службы в реестре. Поэтому работать с реестром вручную не придется.
Таким образом, для запуска служб необходимо установить это приложение (ссылка ниже). Вы также сами можете прописать службы для автозагрузки минуя эту утилиту, для этого вам вручную придется создать секцию в разделе HKLM\\init и контролировать её.
Мы выполним регистрацию службы немного позднее, когда разберемся с возможностью взаимодействия службы с другими приложениями.
\nАналогично службе Windows, службы для Windows Phone имеют несколько состояний:
\nStarting);Running);Suspending);Suspended);Resuming);Exiting);Exited).Узнать текущее состояние службы можно из свойства ServiceState базового класса службы ServiceApplication. Кроме того, в базовом классе присутствует два события, позволяющих отловить моменты изменения текущего состояния службы – OnServiceStateChanged и OnServiceExiting. Как следует из названия, первое событие генерируется всякий раз, когда изменяется текущее состояние сервиса, а второе – в момент завершения службы. Для примера давайте сохранять текущее состояние службы в лог при его изменении. Для этого в конструкторе подпишемся на соответствующее событие и создадим обработчик.
private BackgroundService()\n{\n // ..\n\n OnServiceStateChanged += ServiceStateChanged;\n}\n\nvoid ServiceStateChanged(ServiceStateEventArgs serviceStateEventArgs)\n{\n WriteLog(String.Format(\"Current stat of servce is {0}\",\n serviceStateEventArgs.ServiceState));\n}Для управления состоянием службы в базовом классе ServiceApplication существует набор методов:
StartSuspendResumeQuitЭти методы позволяют управлять работой службы. Кроме того, в базовом классе они определены как виртуальные. Это означает, что их можно переопределить непосредственно в классе службы и задать какое-то собственное поведение. Однако, после (или до) выполнения ваших действий, управление все-таки следует передать методу, определенному в базовом классе, иначе служба не запустится/не остановится/и т.д.
\npublic override void Start()\n{\n // do something\n\n base.Start();\n\n // do something\n}На самом деле вы можете изменять состояние свойства ServiceState самостоятельно в процессе работы службы. Однако, это уже делает базовый класс ServiceApplication, поэтому об этом можно не заботиться.
Практически каждая фоновая служба может (и должна) иметь приложение с пользовательским интерфейсом, которое будет управлять работой службы. Например, если фоновая служба ведет запись GPS-трека, то это приложение может управлять записью (начать, остановить), а также запускать или останавливать работу фоновой службы.
\nС точки зрения фоновой службы, приложение, управляющее её работой является отдельным приложением, оно запускается отдельным процессом и, по сути, не имеет каких-то общих точек соприкосновения со службой. Взаимодействие этого приложения и фоновой службы происходит посредством обмена сообщениями Windows.
\nПолучить список служб, установленных на устройстве можно путем считывания всех значений из ключа реестра HKEY_LOCAL_MACHINE\\Software\\ManagedServices. Для взаимодействия с фоновой службой потребуется знать только её идентификатор. Если приложение знает идентификатор службы, с которой будет работать (что бывает зачастую), то ему не потребуется считывать соответствующие ключи реестра.
Согласно документации, для определения сообщения мы можем использовать идентификаторы, значения которых больше, чем 0x400. В базовом классе уже определено несколько стандартных сообщений.
public const int UM_QUIT_SERVICE = 6028;\npublic const int UM_RESUME_SERVICE = 6027;\npublic const int UM_START_SERVICE = 6025;\npublic const int UM_SUSPEND_SERVICE = 6026;\npublic const int WM_USER = 1024;Название этих сообщений говорит само за себя. Эти сообщения обрабатываются базовым классом и создавать для них собственные обработчики не нужно.
\nДля того, чтобы добавить обработчик для собственного события в конструкторе сервиса следует вызвать метод RegisterMessage и передать ему код сообщения. После этого следует подписаться на событие OnRegisteredMessage и определить логику обработки для этих сообщений.
Давайте определим сообщение, которое будет очищать лог файл. Для этого определим код соответствующего сообщения и зададим для него обработчик.
\nprivate const int UM_CLEAR = WM_USER + 5010;\n\nprivate BackgroundService()\n{\n // ..\n\n RegisterMessage(UM_CLEAR);\n\n OnRegisteredMessage += OnRegisteredMessageProcessing;\n}\n\nvoid OnRegisteredMessageProcessing(ref Message message)\n{\n switch (message.Msg)\n {\n case UM_CLEAR:\n File.Delete(@\"\\smslog.txt\");\n break;\n }\n}Теперь при поступлении сообщения с кодом 6034 (WM_USER + 5010) это сообщение будет обработано и файл будет удален.
Осталось разработать приложение с пользовательским интерфейсом, которое будет управлять фоновой службой. Для этого создадим новое приложение и разместим на нем кнопку Clear Log. Для отправки сообщений Windows создадим небольшой класс, позволяющий выполнить это действие. Я не буду приводить код этого класса, его вы можете увидеть в исходных кодах, приложенных к описанию. Обработчик кнопки для очистки лога будет выглядеть следующим образом.
private const int WM_USER = 1024;\nprivate const int UM_CLEAR = WM_USER + 5010;\n\nprivate void ClearLogButton_Click(object sender, EventArgs e)\n{\n MessageHelper.SendMessage(\"ea6e9740469811df88eebf5256d89593\",\n UM_CLEAR);\n}Теперь при нажатии на кнопку (при запущенной службе) сообщение будет отправлено службе и файл с логами будет удален.
\nТаким образом, мы рассмотрели процесс создания фоновых сервисов для Windows Phone Classic в рамках .NET Compact Framework. Несмотря на то, что поддержка таких служб не поддерживается изначально в .NET Compact Framework, существуют обертки, которые позволяют с относительно небольшими усилиями такие службы создавать.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-mobile-background-services/e25851f9/windows_mobile-background-services@cover.jpg" }, { "id": "https://blog.zwezdin.com/2010/visual-studio-developer-contest/", "url": "https://blog.zwezdin.com/2010/visual-studio-developer-contest/", "title": "Конкурс для разработчиков, использующих в своей работе Visual Studio", "date_published": "2010-04-08T12:00:00.000Z", "content_html": "За последние несколько месяцев у меня накопилось много всяких интересных вещей (в т.ч. полученных в рамках IT-bonus), которые не жалко подарить хорошим людям. Однако, дарить это случайным образом не интересно и не по-спортивному. Так родилась идея провести небольшой конкурс среди разработчиков и IT-профессионалов. Поскольку совсем скоро нас ожидает запуск Visual Studio 2010, то было решено посвятить конкурс именно этой теме.
\nИтак, идея конкурса состоит в следующем. Каждый кто желает участвовать в конкурсе может написать небольшую заметку у себя в блоге на тему разработки в Visual Studio. В этой заметке обязательно должна присутствовать ссылка на это сообщение (для того, чтобы другие разработчики также узнали о существовании конкурса). После этого в комментариях к этому сообщению следует оставить ссылку на свою заметку (комментарии публиковаться не будут до окончания конкурса). В момент подведения итогов я опубликую ссылки на все статьи. Для того, чтобы избежать дублирования статей (чтобы участники не “перенимали” идеи друг у друга), при появлении одинаковых статей, в конкурсе будет участвовать только та, чья ссылка была добавлена сюда раньше.
\nМне бы не хотелось получить статьи с перечислением функций Visual Studio или описанием работы окна Solution Explorer. Было бы интересно, если бы вы написали каким образом вам удается выжать из вашей среды разработки все соки; о том какие приемы, подходы и практики вы используете при работе с Visual Studio, которые делают вашу разработку более эффективной. Это может быть описание набора плагинов, которые позволяют быть эффективным разработчику, практикующему TDD или другие практики. Или же это может быть описание подходов к организации каких-либо сниппетов, которые ускоряют разработку приложений. Также это может быть просто набор практик, которые можно использовать при работе в Visual Studio. Т.е. здесь вы не ограничены какими-то рамками и можете просто рассказать о том, как вам удается быть эффективным вместе с Visual Studio. Таким образом, предполагается, что участвовать в конкурсе будут небольшие статьи в стиле Tips&Tricks.
\nКонкурс начинается 9 апреля 2010 г. и заканчивается 9 мая 2010 г. Результаты конкурса будут объявлены до 15 мая 2010 г. в этом блоге.
\nНа протяжении этого времени вы можете писать свои статьи и публиковать ссылки здесь. Количество статей одно автора не ограничивается (т.е. вы можете написать несколько статей).
\nКонечно любой конкурс – это прежде всего спортивное соревнование со своими коллегами, спортивный интерес. Однако, этот интерес будет еще большим при наличии материальных призов. Конечно в качестве приза Mercedes Benz SL65 AMG не обещаю, но кое-какие призы все-таки будут.
\nПризы не будут разделяться по местам, мы просто разделим их между победителями неформально (если вам хочется получить какой-то конкретный приз из перечисленных – напишите об этом в комментариях вместе со ссылкой на свою статью). Итак, призы.
\nПервый приз – это настоящая гемейрская мышь Microsoft SideWinder Gaming Laser Mouse (1 шт.). К особенностям этой мыши относятся:
\nСледующий приз – веб-камера Microsoft LifeCam VX-5000 (1 шт.). К особенностям камеры относятся:
\nКамера LifeCam VX-5000 – отличное решение для общения в интернет.
\nЕще один приз – пивной бокал с символикой Visual Studio 2010 и MSDN (4 шт.).
\nНаверняка у большинства уже есть такие, но когда в гости приходят друзья-разработчики бокалов, как говорится, лишних не бывает.
\nГлавная особенность бокала состоит в том, что его нельзя нигде купить ни за какие деньги, а можно только получить бесплатно, в т.ч. участвуя в этом конкурсе.
\nДругой приз (один из наиболее ценных) – книга Windows для профессионалов Джеффри Рихтера (2 шт.).
\nЯ не буду говорить об особенностях книги. По своему это – очень нужный настольный справочник, который должен быть у каждого разработчика под Windows.
\nКак известно, книга – лучший подарок. Разве не так?
\nНу и напоследок самое ценное – ваучеры на бесплатную сдачу любого сертификационного экзамена Microsoft (4 шт.).
\nПри наличии этого ваучера вы можете подтвердить свою высокую квалификацию разработчика или ИТ-профессионала в любом городе, где есть центры тестирования и получить почетное звание Microsoft Certified Professional.
\nТаким образом, у нас есть 12 призов, и запуск Visual Studio 2010 будет происходить 12 апреля, поэтому на этом количестве мы пока и остановимся.
\nТакже вместе с каждым призом (кроме ваучеров на сдачу MCP-экзаменов) также будет выслан диск с записями докладов с ресурса TechDays.ru.
\nКроме того, количество призов может быть увеличено, если количество достойных работ будет больше количества призов.
\nЧтобы упростить процесс завершения конкурса и избежать моего субъективного мнения, оценкой работ будут заниматься несколько человек, обладающих статусом Microsoft MVP:
\nОценка работ будет происходить с 9 по 15 мая 2010 г. Результаты будут объявлены не позднее 15 мая 2010 г.
\nЧтобы сделать конкурс еще более интересным, мне бы хотелось привлечь как можно больше участников. Поэтому я был бы вам очень благодарен, если бы вы порекламировали этот конкурс на своих ресурсах. Вы можете просто написать пару слов о конкурсе со ссылкой на эту статью или отправить ссылку в твиттер-ленту (например, используя кнопку внизу этой статьи). Вы также можете использовать любые другие способы, чтобы сообщить об этом конкурсе своим друзьям, коллегам, всем заинтересованным лицам. Ведь чем нас будет больше, тем интереснее!
\nТакже, если вы окажете действительно реальную помощь в популяризации конкурса, то для вас тоже найдутся какие-нибудь призы.
\nВо-первых, мы получим огромное количество удовольствия от духа соревнования, причем сделаем это очень неформально, отчего удовольствия будет только больше (конкурс не завязан на какую-либо конкретную компанию или акцию, это - моя личная инициатива).
\nВо-вторых, после завершения конкурса мы получим (я надеюсь) огромное число бесценных статей на тему того, как сделать разработку в Visual Studio еще более эффективной (а ведь это именно то, чем мы с вами занимаемся каждый день!) .
\nНу и в-третьих, каждый автор, поделившийся своим уникальным опытом получит свой приз (мелочь, а приятно).
\nЯ надеюсь, что этот конкурс все-таки получится и призы найдут своих обладателей. Ну а если конкурс будет иметь успех среди разработчиков, то можно будет устраивать его периодически, изменяя тематику и набор призов.
\nПоехали!
", "tags": [ "Visual Studio", "Конкурсы" ], "banner_image": "https://blog.zwezdin.com/2010/visual-studio-developer-contest/430ddcd2/visual_studio-developer-contest@cover.jpg" }, { "id": "https://blog.zwezdin.com/2010/windows-phone-background-tasking/", "url": "https://blog.zwezdin.com/2010/windows-phone-background-tasking/", "title": "Фоновое исполнение задач в Windows Phone 7", "date_published": "2010-04-08T12:00:00.000Z", "content_html": "Мой рассказ о мультизадачности в Windows Phone 7 вызвал неоднозначную реакцию среди будущих пользователей и разработчиков для этой мобильной платформы. В итоге за две недели я получил больше сотни комментариев из различных источников (в блоге, на сторонних ресурсах, в почте, в IM). В основном авторы этих комментариев были недовольны отсутствием многозадачности в Windows Phone 7. Давайте разберемся как же все-таки обстоят дела на самом деле.
\nГлавное, что хочется сказать – это многозадачность в Windows Phone 7 есть (дочитайте до конца и убедитесь, что это действительно так). Процессы в операционной системе исполняются параллельно и могут обрабатывать задачи пользователя.
\nПутаницу вызывает то, что Windows Phone 7 приостанавливает приложения Silverlight и XNA при переключении на другое приложение или при возникновении какого-либо события (например, звонок по телефону). Более того, приложение может быть и вовсе удалено из памяти, если операционной системе будет недостаточно ресурсов (состояние приложение при этом не теряется и будет восстановлено операционной системой при следующем запуске приложения).
\nОднако, как я уже писал, команда разработчиков в ближайшем будущем начнет работы над созданием службы для выполнения фоновых задач. Это означает, что вы сможете написать собственную фоновую службу и запустить ее на Windows Phone 7. Эта служба будет работать как фоновый процесс и не будет прерываться операционной системой. При этом, судя по всему, приложение Silverlight или XNA сможет взаимодействовать с вашей фоновой службой и управлять ею.
\nТаким образом, для приложений, которым важна именно работа в фоне предлагается модель разработки, при которой приложение на Silverlight/XNA будет некоторой графической оболочкой, а фоновая служба – некоторой логикой, которая работает постоянно. В таком случае приостановка/выгрузка именно приложения Silverlight/XNA очень логично, поскольку это всего лишь пользовательский интерфейс для работающей в фоне службы (которая, напомню, не приостанавливается).
\nКроме того, нужно не забывать о том, что в Windows Phone 7 существуют уведомление (Push Notifications), которые позволяют по внешнему событию восстановить работу и приложения Silverlight/XNA, т.е. по сути запустить нашу графическую оболочку.
\nЕще одним подтверждением наличия многозадачности является то, что эмулятор, поставляемый в составе Windows Phone Developers Tools CTP на данный момент не реализует полностью функциональность приостановки приложений в момент переключения. Это означает, что если мы напишем небольшое приложение, которое по таймеру увеличивает счетчик и отображает его на форме, запустим приложение и переключимся на другое приложение, то таймер все равно будет работать.
\nЕстественно эта недоработка версии CTP будет исправлена в последующих выпусках. Однако сейчас это дает право убедиться в том, что на уровне операционной системы многозадачность поддерживается в полном объеме.
\nПримеры задач, требующих фонового исполнения, которые смогли привести мои собеседники:
\nКак видно, предложенный подход к организации многозадачности позволяет покрыть каждый из этих сценариев. Это означает, что Windows Phone 7 есть полноценная многозадачность, а не “немного многозадачности”.
\nНа этом, я надеюсь, мифы об отсутствии многозадачности в Windows Phone 7 будут развенчаны, а будущие пользователи Windows Phone 7 останутся довольными.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-phone-background-tasking/aeed5f0e/windows_phone-background-tasking@cover.jpg" }, { "id": "https://blog.zwezdin.com/2010/windows-phone-multitasking/", "url": "https://blog.zwezdin.com/2010/windows-phone-multitasking/", "title": "Многозадачность в Windows Phone 7", "date_published": "2010-03-23T13:00:00.000Z", "content_html": "Одним из наиболее спорным вопросом, обсуждаемых при рассмотрении Windows Phone 7 является многозадачность, а точнее ее отсутствие. Как выяснилось, этот вопрос вызывает озабоченность у большого числа пользователей и разработчиков. Давайте подробнее рассмотрим этот вопрос. Для этого обратимся к реализации многозадачности в Windows Phone Classic (старое название – Windows Mobile 5.x, 6.x).
\nВ Windows Phone Classic многозадачность была реализована в полной мере. Это означает, что в один и тот же момент времени без приостановки могут выполнятся несколько приложений. Это, по сути, некоторый аналог настольной платформе, где этот процесс выглядит аналогичным образом. Однако, давайте подумаем – а действительно ли использование подобного подхода для мобильной платформы также обоснованно, как и для настольной?
\nДавайте попробуем представить типичный сценарий использования мобильных устройств. Наверняка он будет включать в себя использование нескольких приложений поочередно в течении длительного количества времени. Например, в данный момент я использую несколько таких приложений: просмотр фотографий, чтение электронной почты, чтение ленты Twitter, просмотр текущего трафика, Windows Media Player, редактирование и просмотр документов Microsoft Office, просмотр документов PDF, калькулятор и др. При длительном использовании устройства можно обнаружить, что в памяти загружены все или часть этих приложений, при этом в данный момент они совершенно не нужны, поскольку нет необходимости в их использовании. Тем не менее, в данный момент они действительно загружены в память и исполняются, загружают центральный процессор, занимают память и расходуют батарею. Конечно, некоторая часть пользователей внимательно следит за тем, чтобы в данный момент были загружены только необходимые приложения, но так делают далеко не все. Именно по этой причине использование подобного подхода не является обоснованным для мобильной платформы.
\nВ некоторых мобильных платформах существует другая крайность — возможность запускать в каждый момент времени только одно приложение. Такой подход также не является правильным, поскольку иногда все же необходимо запускать одновременно несколько приложений. Классический пример – использование проигрывателя музыки в момент использования других приложений, например, чтении почты.
\nРазработчики Windows Phone 7 решили не прибегать к крайностям и выбрали золотую середину. В Windows Phone 7 в каждый момент времени может выполнятся только одно запущенное приложение. При этом существует набор системных приложений, которые могут выполняться “в фоне”. При переходе на главное окно или переключении на другие окна, текущее приложение переключается в приостановленное состояние. Что интересно, операционная система в произвольный момент времени может вовсе удалить этот процесс из памяти. Поэтому в момент приостановки следует сохранить состояние приложения, а в момент возврата к приложению – восстановить это состояние. Служебные механизмы Windows Phone 7 самостоятельно выполняют действия по сохранению и восстановлению состояния, поэтому разработчику приложения не нужно об этом заботиться. Пользователь при переключении между приложениями также не заметит никакой разницы, если приложение было удалено из памяти – он вернется к тому состоянию, в котором находилось приложение в последний раз.
\n\n\n\n![\"Многозадачность](\"https://blog.zwezdin.com/2010/windows-phone-multitasking/4315b8c8/1@2x.png\")
\n\n\n\n\nСуществует также еще один тип событий, которые могут прерывать выполнение приложения. Однако, в отличии от предыдущего сценария, в данном случае прерывание происходит на короткий промежуток времени. Такие прерывания могут случаться, например, при поступлении входящего вызова или при срабатывании будильника. В этом случае приложение продолжает свою работу в фоновом режиме. Однако, если приложение требует от пользователя постоянного взаимодействия (например, игровое приложение), разработчик этого приложения может реагировать на подобные события и принудительно приостанавливать работу приложения на время обработки внешнего события.
\nОписанный выше процесс с точки зрения мобильной платформы является более правильным, поскольку позволяет не тратить ресурсы на выполнение ненужных фоновых приложений. Более того, в этом случае состояние приложения сохраняется и восстанавливается в автоматическом режиме, что несомненно очень удобно с точки зрения разработчика приложений.
\nОднако, ряд задач не могут быть реализованы при использовании описанного процесса. Дело в том, что есть некоторые задачи, которые требуют фонового исполнения. Например, это может быть приложение для записи GPS-трека пользователя или будильник, который должен сработать в определенный момент. К сожалению, в той версии Windows Phone 7, которая была представлена на MIX 2010 эта функциональность не реализована. Однако, команда разработчиков в данный момент занимается этим сценарием и в ближайшее время мы с вами сможем попробовать реализовать и такие сценарии.
\nТаким образом, видно, что подход для организации работы множества приложений в Windows Phone 7 стал более эффективным, чем он был реализован ранее, в Windows Phone Classic.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2010/windows-phone-multitasking/709d1f46/windows_phone-multitasking@cover.jpg" }, { "id": "https://blog.zwezdin.com/2010/what-is-windows-phone-7/", "url": "https://blog.zwezdin.com/2010/what-is-windows-phone-7/", "title": "Windows Phone 7 — что таит в себе новая мобильная платформа", "date_published": "2010-03-21T13:00:00.000Z", "content_html": "Прошедшее в феврале 2010 г. мероприятие Mobile World Congress 2010 наделало много шума относительно новой мобильной платформы Windows Phone 7. Однако, многие детали были раскрыты только мероприятии MIX 2010, которое прошло в марте 2010 г. Платформа Windows Phone 7 действительно хороша, в ней сделаны коренные изменения, подарившие вторую жизнь мобильной платформе Microsoft. Однако, как видно по многочисленным отзывам, многими эти изменения были восприняты неправильно и они сделали неверные выводы. На самом деле большинство решений, принятых при разработке Windows Phone 7 очень логичные и правильные, и именно они помогут платформе выйти на новый, более качественный уровень. Поэтому на протяжении нескольких заметок я расскажу о различных аспектах новой мобильной платформы и разработке для нее. Рассказ будет строится с позиции разработчиков приложений для мобильных платформ.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2010/what-is-windows-phone-7/980af78e/1@2x.png\")
\n\n\n\n\nИтак, первое что бросается в глаза при рассмотрении Windows Phone 7 – это очень смелые и радикальные шаги команды разработчиков по изменению направления развития самой платформы. Если раньше Windows Mobile позиционировалась как мобильная платформа для бизнес-приложений, являющаяся, по сути, облегченным вариантом настольной операционной системы, то сейчас Windows Phone 7 позиционируется как платформа, ориентированная на конечного пользователя. Плохо это или хорошо? Давайте попробуем разобраться. Для этого давайте посмотрим для каких сценариев разрабатываются мобильные приложения:
\nНетрудно догадаться, что потребности в приложениях для обычных пользователей намного выше. Действительно, огромное число пользователей смартфонов и коммуникаторов используют их для фотографирования, чтения почты, общения в различных социальных сетях и программах обмена мгновенными сообщениями; при этом гораздо меньшее число пользователей используют свои устройства для работы с корпоративными документами или работе в какой-либо корпоративной системе. Это говорит о том, что подавляющее число пользователей подобных устройств в большей степени нуждается в несложных приложениях для повседневного использования и в меньшей – в бизнес-приложениях. В то же время успех платформы определяется тем, насколько хорошо она решает проблемы своих пользователей. Поэтому не удивительно почему был сделан именно такой шаг. Однако, это вовсе не означает, что корпоративный пользователь забыт, просто ему уделяется несколько меньше внимания.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2010/what-is-windows-phone-7/01d609a8/2@2x.png\")
\n\n\n\n\nПри таком подходе успех или неуспех платформы сильно зависит от того, насколько активно независимые разработчики будут разрабатывать приложения для новой платформы. Поэтому задача разработчиков Windows Phone 7 заключалась в том, чтобы сделать этот процесс одновременно простым и гибким. Это означает, что разработчик приложений должен создавать новые приложения, затрачивая при этом минимальные усилия по обеспечению инфраструктуры (механизмы построения пользовательского интерфейса, обновления, работа с данными, защита приложения и т.д.). Поэтому разработка приложений осуществляется на базе двух основных платформ – XNA и Silverlight. Платформа XNA подходит для создания игровых приложений, в то время как Silverlight используется для всех остальных случаев. Однако, это не означает, что вы не можете создавать игр на Silverlight или, наоборот, приложения для чтения RSS-ленты на XNA. Как видно, в обоих случаях используется управляемый код, что позволяет сделать приложения более управляемыми и контролируемыми со стороны операционной системы. В целом платформу разработки можно представить следующим образом.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2010/what-is-windows-phone-7/d2f9b7ce/3@2x.png\")
\n\n\n\n\nWindows Phone 7 поддерживает надмножество Silverlight 3. Это означает, что мы можем легко портировать существующие Silverlight-приложения на мобильную платформу. При этом приложение может одинаково корректно работать как на PC, так и на мобильном устройстве. С платформой XNA ситуация похожая – разработанный однажды код может одновременно работать на PC, XBOX и мобильном устройстве. Это дает пользователю использовать аналогичные возможности на всех указанных устройствах и тем самым повышать эффективность его работы. В Microsoft это называют концепцией трех экранов.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2010/what-is-windows-phone-7/26e1ade3/4@2x.png\")
\n\n\n\n\nДля разработки приложений существует отдельная редакция Visual Studio Express for Windows Phone, которая поставляется бесплатно. Также возможно разрабатывать для Windows Phone 7, используя приложение Expression Blend. Эти и другие инструменты можно найти на портале developer.windowsphone.com.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2010/what-is-windows-phone-7/7716b252/5@2x.png\")
\n\n\n\n\nПоскольку платформа Windows Phone 7 ориентирована в большей степени на потребителя, то важную роль в ней занимает пользовательский интерфейс. В этом вопросе было принято решение использовать успешный опыт пользовательского интерфейса Zune HD и остановиться на подобном графическом решении. Сами разработчики называют это решение как «язык дизайна Metro» — это не просто цветовое оформление пользовательского интерфеса, это – целая философия того, как нужно строить пользовательский интерфейс. В основу Metro заложены несколько главных идей:
\nУспешным ли получился пользовательский интерфейс оценят потребители, однако он уже имел успех среди пользователей Zune HD, поэтому можно предположить, что и здесь он найдет своего потребителя.
\nПоследнее о чем хочется сказать, рассматривая Windows Phone 7 — это попытка команды разработчиков стандартизации аппаратного обеспечения. Опыт с Windows Mobile (когда аппаратное обеспечения отличается от модели к модели) показал, что это очень осложняет жизнь разработчику. Вводя четкие стандарты, Microsoft дает возможность разработчикам быть точно уверенным в том, есть ли в наличии то или иное устройство и какими характеристиками оно обладает. Таким образом, Windows Phone 7 содержит минимальные требования к аппаратной платформе, которые выглядят следующим образом:
\nПлохо это или хорошо, что есть жесткие ограничения, предъявляемые к устройству? Я думаю, что это очень хорошо. Производители мобильных устройств скорее всего найдут в себе силы для создания подобной платформы, а разработчикам приложения это позволит не ограничиваться старыми устройствами.
\nВ итоге, видно, что платформа Windows Phone 7 – это второе дыхание мобильной платформы Microsoft, которая имеет все шансы на успех. Наступит ли этот успех покажет время. Далее мы продолжим рассматривать особенности Windows Phone 7 и будем говорить о различных аспектах разработки для новой мобильной платформы.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2010/what-is-windows-phone-7/47633c5d/6@2x.png\")
",
"tags": [
"Windows Phone"
],
"banner_image": "https://blog.zwezdin.com/2010/what-is-windows-phone-7/9f7493d5/what_is-windows-phone-7@cover.png"
},
{
"id": "https://blog.zwezdin.com/2009/windows-mobile-location-aware/",
"url": "https://blog.zwezdin.com/2009/windows-mobile-location-aware/",
"title": "Как определить \"Где я?\" в приложениях на Windows Mobile",
"date_published": "2009-12-08T13:00:00.000Z",
"content_html": "На сегодняшний день многие приложения - мобильные и настольные - приобретают новые возможности и реализуют различные интересные и нестандартные сценарии. К таким необычным на сегодняшний день приложениям можно отнести приложения, адаптирующиеся к текущим условиям, в которых находится пользователь. Например, это может быть приложение, которое изменяет яркость и размер шрифта при плохом освещении или приложение, которое изменяет свой пользовательский интерфейс в зависимости от того, где сейчас находится пользователь (дома, в офисе и т.д.). Такие приложения имеют общее название - контекстно-зависимые приложения. Одним из частных случаев контекстно-зависимых приложений является приложения, зависящие от географического местоположения пользователя. Например, если приложение отображает прогноз погоды, то логично было бы отображать его именно для той местности где находится пользователь. Точно также было бы логично вести отсчет времени именно в том часовом поясе, где находится пользователь. Примеров подобных сценариев можно привести много, что еще раз доказывает ценность подобных приложений в реальной жизни.
\nКаким образом реализуются приложения, зависящие от местоположения сегодня? Как правило, на ум сразу приходит использование GPS-устройств, которые способны предоставлять координаты текущего местоположения. Однако, GPS устройства есть далеко не везде и не всегда. Более того, применение GPS-устройств ограничивается тем, что их нельзя использовать внутри зданий и закрытых помещениях. Засчастую на этом этапе заканчиваются идеи относительно получения текущего местоположения. Однако, если задуматься, то существуют и другие источники получения этой информации. Поскольку в нашем случае речь идет о Windows Mobile, а устройства на базе этой операционной системы зачастую обладают GSM-модулем, то информацию о местоположении можно брать с базовых станций состовых операторов. Кроме того, не стоит забывать про сервисы определения местоположения по IP-адресу – на подобных устройствах мобильный интернет настроен в большинстве случаев.
\nКаждый из приведенных выше способов имеет собственные преимущества и недостатки. Поэтому каждый способ может работать только в определенных условиях и при определенных ограничениях. Наиболее правильный способ – использовать все приведенные ранее способы и объеденить преимущества этих способов в одном приложении.
\nНа протяжении данной статьи мы рассмотрим процесс создания приложения для Windows Mobile, при котором мы будем использовать несколько альтернативных источников получения информации и построим приложение, которое может получать информацию о местоположении в различных условиях. Прежде чем переходить к реализации самого приложения давайте рассмотрим каждый из способов получения информации о местоположении.
\nGPS — это наиболее популярный способ получения информации о местоположении. Этот способ работает в устройствах, оборудованных приемником GPS. Для этого GPS-приемник использует одновременно несколько спутников (минимум 4) и на основании этого получает координаты текущего местоположения. Кроме непосредственно координат, GPS-приемник предоставляет также информацию о текущей скорости, направлении (север-юг-запад-восток), высоте и т.д. В нашем случае понадобятся только координаты, поэтому остальные параметры мы использовать не будем.
\nК преимуществам этого способа можно отнести точность получаемой информации и возможность ее постоянного обновления (в случае перемещения). Более того, в общем случае, для получения координат не требуется подключение к Интернет или сети сотового оператора. Однако, у GPS есть также и недостатки. Во-первых, GPS-приемники, как правило, не работают в закрытых помещениях (это связано с особенностями самой технологии). Во-вторых, зачастую GPS-приемнику требуется некоторое время (от нескольких секунд до нескольких минут) для того, чтобы установить связь со спутниками. Наконец, в какие-то моменты времени GPS-приемник может просто не установить связь со спутниками из-за погодных условий, вашего расположения относительно спутников или других причин. Все это создает неудобства при работе с GPS, а в некоторых ситуациях может сделать невозможным использование данного способа.
\nДля работы с GPS-приемником в Windows Mobile могут использоваться различные подходы. Обычно GPS-приемник поставляет свои данные через COM-порт. Поэтому можно подключиться к нему и считывать всю необходимую информацию. Однако, при таком подходе могут быть проблемы с подключением нескольких приложений к GPS-приемнику. Кроме того, в этом случае нам придется вручную разбирать форматы данных, которые поступают от приемника (мелочь, а не приятно). Поэтому в данном случае рекомендуется использовать некоторую «прослойку» в Windows Mobile, которая позволяет централизованно получить информацию с GPS-устройства – GPS API. По сути, GPS API работает напрямую с COM-портом, обрабатывает данные и предоставляет интерфейсы для других приложений. Используя GPS API, приложения могут получать всю информацию, которая доступна от GPS-приемника.
\nДля работы с GPS API в Windows Mobile существует библиотека gpsapi.dll, которая поставляется вместе с операционной системой. Эта библиотека является неуправляемой, поэтому для работы с ней необходимо использовать PInvoke. К счастью, в Microsoft уже сделали управляемую обертку для этой библиотеки, которая поставляется вместе с Windows Mobile 6 SDK. В нашем случае мы возьмем эту обертку для использования в нашем приложении.
Использование управляемой обертки является достаточно простым. Для этого необходимо создать объект NativeWrapperGps, подписаться на событие LocationChanged и вызвать метод Open. При изменении текущего местоположения будет сгенерировано событие LocationChanged. После окончания работы с GPS-устройством необходимо вызвать метод Close. В общем случае работа через GPS API может выглядеть следующим образом.
var gps = new NativeWrapperGps();\ngps.LocationChanged +=\n delegate(object sender, NativeWrapperGps.LocationChangedEventArgs args)\n {\n // ...\n };\n\ngps.Open();\n// ...\ngps.Close();Таким образом, мы можем работать с GPS-приемником в Windows Mobile и получать информацию о текущем местоположении.
\nДругим источником информации о текущем местоположении может служить информация, которая доступна от оператора сотовой связи. Поскольку сети беспроводной связи строятся по принципу «сот», то в каждый момент мы работаем с какой-либо конкретной базовой станцией. Каждая базовая станция имеет некий уникальный идентификатор, который определяет каждую базовую станцию. Этот идентификатор состоит из нескольких значений – Cell ID (или Tower ID), Location Area Code (LAC), Mobile Country Code (MCC) и Mobile Network Code (MNC). Все эти значения можно получить от базовой станции и они будут уникальными для каждой базовой станции.
Тем не менее, сам по себе данный идентификатор не представляет ценной информации о местоположении. Однако, существуют централизованные базы данных, сопоставляющие эти идентификаторы с географической информацией. Понятно, что точность определения местоположения пользователя зависит от того, какую площадь обслуживает базовая станция. Однако, такая точность может удовлетворять пользователя достаточно часто.
\nТаким образом, предложенный способ не содержит недостатков способа определения местоположения с помощью GPS – не требуется длительная инициализация, процесс определения не зависит от погодных условий и положения спутников, а определение местоположения происходит достаточно быстро. Однако, у приведенного способа есть и недостатки. Основным недостатком является низкая точность определения местоположения: если GPS определяет координаты с точностью до нескольких метров, то приведенный способ может «ошибиться» на несколько километров. Кроме того, централизованные базы данных могут не содержать информацию о базовой станции с которой вы сейчас работаете – в этом случае определить местоположение невозможно. Наконец, для определения местоположения требуется наличие покрытия территории сетями мобильных операторов, а также требуется доступ к Интернет (GPRS, EDGE, 3G и т.д.). Доступ к глобальной сети необдоходим для того, чтобы воспользоваться услугами централизованных баз данных для определения координат. Таким образом, видно, что данный способ имеет достаточно серьезные ограничение, но в некоторых случаях может применяться достаточно успешно.
\nДля того, чтобы получать информацию от GSM-модуля телефона можно воспользоваться библиотекой ril.dll (RIL, Radio Interface Layer). Эта библиотека поставляется вместе с операционной системой и разработана на неуправляемом коде. По этой причине использовать её функции можно через PInvoke. В рамках RIL доступно множество интересных функций, которыми можно воспользоваться. В нашем случае необходимо получить информацию о базовой станции, это можно сделать используя функцию GetCellTowerInfo. Перед использованием этой функции необходимо вызвать функцию инициализации, а после использования — деинициализации. При инициализации указывается метод, который будет вызван после получения информации (процесс получения информации о базовой станции асинхронный). Таким образом, для работы с RIL потребуется небольшая обертка над неуправляемой библиотекой.
public static class RilInterop\n{\n public delegate void RilResultCallback(uint dwCode, IntPtr hrCmdID, IntPtr lpData, uint cbData, uint dwParam);\n\n public delegate void RilNotifyCallback(uint dwCode, IntPtr lpData, uint cbData, uint dwParam);\n\n [DllImport(\"ril.dll\", EntryPoint = \"RIL_Initialize\")]\n public static extern IntPtr Initialize(uint dwIndex, RilResultCallback pfnResult, RilNotifyCallback pfnNotify, uint dwNotificationClasses, uint dwParam, out IntPtr lphRil);\n\n [DllImport(\"ril.dll\", EntryPoint = \"RIL_GetCellTowerInfo\")]\n public static extern IntPtr GetCellTowerInfo(IntPtr hRil);\n\n [DllImport(\"ril.dll\", EntryPoint = \"RIL_Deinitialize\")]\n public static extern IntPtr Deinitialize(IntPtr hRil);\n}После этого необходимо проинициализировать RIL, указать метод обратного вызова, вызвать метод GetCellTowerInfo и вызвать метод деинициализации. Данные будут получены в асинхронном режиме, поэтому если необходимо их получать синхронно нужно воспользоваться объектами синхронизации, например, AutoResetEvent. Таким образом, получение информации о базовой станции будет выглядеть следующим образом.
public class RilWrapper\n{\n private static RilCellTowerInfo _towerDetails;\n\n private static readonly AutoResetEvent WaitHandle = new AutoResetEvent(false);\n\n public static CellTower GetCellTowerInfo()\n {\n IntPtr rilHandle;\n\n if (RilInterop.Initialize(1, CellDataCallback, null, 0, 0, out rilHandle) != IntPtr.Zero)\n {\n return null;\n }\n\n RilInterop.GetCellTowerInfo(rilHandle);\n\n WaitHandle.WaitOne();\n\n RilInterop.Deinitialize(rilHandle);\n\n return new CellTower\n {\n TowerId = Convert.ToInt32(_towerDetails.DwCellID),\n LocationAreaCode = Convert.ToInt32(_towerDetails.DwLocationAreaCode),\n MobileCountryCode = Convert.ToInt32(_towerDetails.DwMobileCountryCode),\n MobileNetworkCode = Convert.ToInt32(_towerDetails.DwMobileNetworkCode),\n };\n }\n\n public static void CellDataCallback(uint dwCode, IntPtr hrCmdID, IntPtr lpData, uint cbData, uint dwParam)\n {\n _towerDetails = new RilCellTowerInfo();\n Marshal.PtrToStructure(lpData, _towerDetails);\n WaitHandle.Set();\n }\n}После вызова метода GetCellTowerInfo() будет возвращен объект, содержащий значения, которые характеризуют текущую базовую станцию. Как было сказано выше, для получения географических координат на основе этой информации необходимо использовать какую-либо общедоступную базу данных. Например, такую информацию содержит открытый сервис OpenCellId (opencellid.org). Используя этот ресурс можно получить координаты местоположения по информации о базовой станции. Используя заданный формат URL, можно обратиться к сервису и получить ответ в виде XML. Для распознования информации от этого сервиса создадим небольшой объект, выполняющий эти функции.
public class OpenCellIdProvider : ICellToGpsProvider\n{\n public GpsLocation GetCoordinates(int cellId, int locationAreaCode, int mobileCountryCode, int mobileNetworkCode)\n {\n GpsLocation result = null;\n\n var doc = XDocument.Load(String.Format(\"http://www.opencellid.org/cell/get?key={4}&mnc={3}&mcc={2}&lac={1}&cellid={0}\", cellId, locationAreaCode, mobileCountryCode, mobileNetworkCode, Key));\n\n if ((doc.Root != null) && (doc.Root.Attribute(XName.Get(\"stat\")).Value == \"ok\"))\n {\n var cellInfoElem = doc.Root.Element(XName.Get(\"cell\"));\n\n if (cellInfoElem != null)\n {\n result = new GpsLocation\n {\n Latitude = Convert.ToDouble(cellInfoElem.Attribute(XName.Get(\"lat\")).Value.Replace('.', ',')),\n Longitude = Convert.ToDouble(cellInfoElem.Attribute(XName.Get(\"lon\")).Value.Replace('.', ','))\n };\n }\n }\n\n return result;\n }\n}Теперь, после получения информации о базовой станции мы можем обратиться к этому сервису и получить координаты текущего местоположения.
\nПоследний способ, который мы рассмотрим в качестве варианта получения текущего местоположение – это определение текущих координат на основе IP-адреса. Поскольку большинство устройств имеют GRPS-подключение к Интернет, то этот способ может достаточно успешно работать. Получение местоположения по IP-адресу – это операция, которая не всегда возвращает достоверную информацию. За счет использования «серых» IP-адресов информация может сильно отличаться от действительности (например, когда российский IP-адрес определяется ирландским). Тем не менее, при использовании мобильного интернета вероятность получения правильной информации выше. Поэтому мы рассмотрим этот метод в качестве одной из альтернатив.
\nСильной стороной этого метода является то, что он не зависит от наличия приемника GPS, погодных условий и возможности соединения спутника. Кроме того, этот способ не зависит от наличия информации в базе данных по базовым станциям. Однако, недостатки у этого метода присутствуют и они являются достаточно существенными. Во-первых, точность определения местоположения зачастую оставляет желать лучшего. Как правило – это рамки города (даже не района). Однако, если этот уровень детализации устраивает, то почему бы и нет? Другой недостаток – это необходимость наличия подключенного интернета; если подключенного интернета нет, то этот способ не работает. Более того, большинство полноценных иструментов определения местоположения по IP-адресу либо являются платными, либо накладывают ограничения на число обращений.
\nТем не менее, давайте возьмем на заметку этот способ на случай, когда все перечисленные ограничения не являются существенными. GeoIp-сервисов существует большое множество. Большинство из них платные, другие могут просто требовать регистрации. В нашем случае мы остановимся на сервисе GeoIpTool (geoiptool.com, в общем же случае можно использовать любой из представленных в сети Интернет. Этот сервис возвращает HTML при обращении к его главной странице, внутри которой есть координаты, соответствющие IP-адресу клиента. В данном случае мы просто обработаем HTML-код и получим из него координаты.
public GpsLocation GetLocation()\n{\n double? lat = null;\n double? lon = null;\n\n var html = GetHtml(\"http://www.geoiptool.com/en/\");\n\n var lines = Regex.Matches(html.Replace(\"\\r\", \" \").Replace(\"\\n\", \" \"), @\"<tr>(.)+?</tr>\", RegexOptions.IgnoreCase);\n foreach (Match line in lines)\n {\n try\n {\n if (line.Value.Contains(\"Longitude:\"))\n {\n lon = Convert.ToDouble(Regex.Match(line.Value, @\"<td(.)*?>(?<val>[0-9\\.]+)</td>\").Groups[\"val\"].Value.Replace('.', ','));\n }\n if (line.Value.Contains(\"Latitude:\"))\n {\n lat = Convert.ToDouble(Regex.Match(line.Value, @\"<td(.)*?>(?<val>[0-9\\.]+)</td>\").Groups[\"val\"].Value.Replace('.', ','));\n }\n }\n catch (FormatException)\n {\n }\n }\n\n return (lat != null) && (lon != null) ? new GpsLocation { Latitude = (double)lat, Longitude = (double)lon } : null;\n}Таким образом, мы можем получить свое местоположение по IP-адресу.
\nТеперь, когда мы умеем определять текущее местоположение как минимум тремя способами, давайте построим приложение, которое будет использовать одновременно все эти способы. Поскольку каждый из способов имет свои преимущества и недостатки расположим эти способы в порядке приоритетов. Понятно, что самым точным способом является определение координат на основе данных GPS. Поэтому приоритетно будем использовать его. В случаях, когда GPS-приемник отсутствует в устройстве или он не может соединиться со спутниками, мы будем использовать данные от базовых станций мобильной сети. В этом случае точность определения будет снижена, но свое примерное местоположение мы узнать сможем. Наконец, если по каким-то причинам мы не смогли узнать местоположение и этим способом (например, данные о текущей базовой станции не найдены в базе данных), то можно узнать местоположение с помощью мобильного интернета и IP-адреса. В этом случае точность снизится еще больше, но информацию мы получим.
\nДля работы в таком режиме хотелось бы иметь общий механизм, которому мы будем задавать вопрос о текущем местоположении, а он в свою очередь уже доступным способом определяет местоположение. Для этого каждый из способов будет реализовывать интерфейс провайдера ILocationProvider, определенный следующим образом.
public interface ILocationProvider\n{\n GpsLocation GetLocation();\n string ProviderName { get; }\n}Этот интерфейс содержит метод для получения текущего местоположения, а также возвращает имя провайдера. После этого необходимо реализовать этот интерфейс в объектах, реализующих логику для каждого из приведенных способов. Несложно догадаться как это можно сделать на основе кода, приведенного для каждого из способов. Наконец, необходим объект, выполняющий функции координирования всех провайдеров, своего рода менеджер. Этот объект должен содержать коллекцию доступных провайдеров и при обращении к нему должен поочередно опрашивать каждого провайдера. Если более приоритетный провайдер сгенерировал исключение или просто вернул null, то нужно обратиться к следующему провайдеру и т.д. Таким образом, получается следующее описание класса для подобного объекта.
\npublic class LocationManager : ILocationProvider\n{\n private readonly List<ILocationProvider> _providers = new List<ILocationProvider>();\n\n private string _lastProviderName = null;\n\n public void ClearProviders()\n {\n _providers.Clear();\n }\n\n public void RegisterProvider(ILocationProvider provider)\n {\n if (_providers.Contains(provider)==false)\n {\n _providers.Add(provider);\n }\n }\n\n public void RemoveProvider(ILocationProvider provider)\n {\n if (_providers.Contains(provider) == true)\n {\n _providers.Remove(provider);\n }\n }\n\n #region ILocationProvider Members\n\n public GpsLocation GetLocation()\n {\n GpsLocation result = null;\n _lastProviderName = null;\n\n foreach (var provider in _providers)\n {\n try\n {\n result = provider.GetLocation();\n\n if (result != null)\n {\n _lastProviderName = provider.ProviderName;\n break;\n }\n }\n catch (Exception ex)\n {\n continue;\n }\n }\n\n return result;\n }\n\n public string ProviderName\n {\n get { return _lastProviderName; }\n }\n\n #endregion\n}Таким образом, для использования этого механизма необходимо зарегистрировать все необходимые провайдеры, а затем обратиться к объекту-менеджеру с вопросом «где я?». Например, этот код может выглядть так.
\nLocationManager manager = new LocationManager();\n\nmanager.RegisterProvider(new GpsLocationProvider());\nmanager.RegisterProvider(new CellLocationProvider(new OpenCellIdProvider()));\nmanager.RegisterProvider(new GeoIpLocationProvider());\n\nvar location = manager.GetLocation();В случае, когда нужно исключить из процесса какой-либо из провайдеров, мы просто его не регистрируем. Напоследок, можно отобразить полученные координаты на карте и вывести их пользователю.
\n\n\n\n![\"Как](\"https://blog.zwezdin.com/2009/windows-mobile-location-aware/5b77eb0b/1@2x.png\")
\n\n\n\n\nТаким образом, мы получили приложение, которое использует несколько альтернативных источников информации для получения своего местоположения: если в данный момент можно использовать GPS, то используется именно этот способ, если же GPS недоступен, то используются альтернативные способы, пусть и менее точные.
\nПриложения, реагирующие на изменение контекста становятся все более популярными в условиях развития современных приложений. Мобильные приложения не являются исключением. Однако, многие разработчики до сих пор считают приемник GPS единственным средством получения информации о текущем местоположении. Здесь мы рассмотрели способ, с помощью которого можно получать подобную информацию в случае невозможности использования GPS и даже без наличия приемника GPS. Зачастую альтернативные способы являются менее точными при определении местоположения, но точность нужна не везде и не всегда – большое количество сценариев отлично реализуются и на основе информации о том, в каком я сейчас городе или даже стране. Поэтому не нужно ограничивать себя в подобных возможностях, а нужно просто включить фантазию и начать использовать контекстно-зависимые сценарии в своих приложениях.
", "tags": [ "Windows Phone" ], "banner_image": "https://blog.zwezdin.com/2009/windows-mobile-location-aware/64f65f71/windows_mobile-location-aware@cover.png" }, { "id": "https://blog.zwezdin.com/2009/adonet-data-services-enums/", "url": "https://blog.zwezdin.com/2009/adonet-data-services-enums/", "title": "Использование перечисляемых типов в ADO.NET Data Services", "date_published": "2009-11-29T13:00:00.000Z", "content_html": "Этой осень довелось пообщаться на тему ADO.NET Data Services в рамках Ижевского сообщества разработчиков. Кроме прочих обсуждаемых вопросов, речь зашла об использовании перечисляемых типов в составе сущности, которая используется в рамках сервиса ADO.NET Data Services. Поскольку в течении этого времени вопросом интересовалось еще несколько человек, решил вынести эту информацию сюда.
\nСуть проблемы заключается в следующем. Предположим мы решили создать сервис на базе ADO.NET Data Services и использовать в его источнике сущность, содержащую поле перечисляемого типа. Обратившись к такому сервису можно увидеть незамысловатую ошибку.
\n\n\n\n![\"Использование](\"https://blog.zwezdin.com/2009/adonet-data-services-enums/fc60f0a4/1@2x.png\")
\n\n\n\n\nМожно посмотреть детали этой ошибки. Для этого необходимо соответствующим образом настроить сервис.
\n[ServiceBehavior(IncludeExceptionDetailInFaults = true)]\npublic class WebDataService1 : DataService<MyDataContext>\n{Обратившись к сервису снова, мы увидим ошибку, которая говорит о том, что перечисляемые типы нельзя использовать в сущностях для подобных сервисах. К сожалению, эта досадная недоработка в ADO.NET Data Services может серьезно подпортить жизнь разработчикам и, как я уже сказал, нет стандартного решения этой проблемы. Давайте попробуем решить эту проблему хотя бы частично.
\nДля этого создадим сущность и перечисляемый тип, который будем использовать в сервисе:
\npublic enum StateEnum\n{\n Normal = 1,\n Error = 2\n}\n\n[DataServiceKey(\"ID\")]\npublic class SampleEntity\n{\n public int ID { get; set; }\n\n public string Name { get; set; }\n\n public StateEnum State\n {\n get;\n set;\n }\n}Теперь создадим собственный контекст данных и стандартный сервис ADO.NET Data Services. Пусть этот контекст содержит статические данные. В вашем случае это может быть контекст с собственной логикой.
\npublic class MyDataContext\n{\n private static readonly IEnumerable<SampleEntity> Entities = new List<SampleEntity>()\n {\n new SampleEntity() {ID = 1, Name = \"Name1\", State = StateEnum.Normal},\n new SampleEntity() {ID = 2, Name = \"Name2\", State = StateEnum.Error},\n new SampleEntity() {ID = 3, Name = \"Name3\", State = StateEnum.Normal},\n new SampleEntity() {ID = 4, Name = \"Name4\", State = StateEnum.Normal},\n new SampleEntity() {ID = 5, Name = \"Name5\", State = StateEnum.Normal},\n };\n\n public IQueryable<SampleEntity> Data\n {\n get\n {\n return Entities.AsQueryable<SampleEntity>();\n }\n }\n}Понятно, что с таким сервисом мы получим ошибку, которую видел в самом начале. Чтобы избежать ошибки мы будем использовать атрибут IgnoreProperties. С его помощью можно указать ADO.NET Data Services о том, что нужно игнорировать указанные свойства. Наша сущность примет следующий вид.
[DataServiceKey(\"ID\")]\n[IgnoreProperties(\"State\")]\npublic class SampleEntity\n{\n public int ID { get; set; }\n\n public string Name { get; set; }\n\n public StateEnum State\n {\n get { return (StateEnum)StateValue; }\n set { StateValue = (int)value; }\n }\n}Отлично, ошибка перестала появляться, но при этом значение данного свойства также перестало передаваться на клиентскую сторону.
\n<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\" ?>\n<feed xml:base=\"http://localhost:4321/WebDataService1.svc/\" xmlns:d=\"http://schemas.microsoft.com/ado/2007/08/dataservices\" xmlns:m=\"http://schemas.microsoft.com/ado/2007/08/dataservices/metadata\" xmlns=\"http://www.w3.org/2005/Atom\">\n <title type=\"text\">Data</title>\n <id>http://localhost:4321/WebDataService1.svc/Data</id>\n <updated>2009-11-29T06:06:57Z</updated>\n <link rel=\"self\" title=\"Data\" href=\"Data\" />\n <entry>\n <id>http://localhost:4321/WebDataService1.svc/Data(1)</id>\n <title type=\"text\" />\n <updated>2009-11-29T06:06:57Z</updated>\n <author>\n <name />\n </author>\n <link rel=\"edit\" title=\"SampleEntity\" href=\"Data(1)\" />\n <category term=\"WebApplication69.SampleEntity\" scheme=\"http://schemas.microsoft.com/ado/2007/08/dataservices/scheme\" />\n <content type=\"application/xml\">\n <m:properties>\n <d:ID m:type=\"Edm.Int32\">1</d:ID>\n <d:Name>Name1</d:Name>\n </m:properties>\n </content>\n </entry>\n <entry>\n <id>http://localhost:4321/WebDataService1.svc/Data(2)</id>\n <title type=\"text\" />\n <updated>2009-11-29T06:06:57Z</updated>\n <author>\n <name />\n </author>\n <link rel=\"edit\" title=\"SampleEntity\" href=\"Data(2)\" />\n <category term=\"WebApplication69.SampleEntity\" scheme=\"http://schemas.microsoft.com/ado/2007/08/dataservices/scheme\" />\n <content type=\"application/xml\">\n <m:properties>\n <d:ID m:type=\"Edm.Int32\">2</d:ID>\n <d:Name>Name2</d:Name>\n </m:properties>\n </content>\n </entry>\n <entry>\n <id>http://localhost:4321/WebDataService1.svc/Data(3)</id>\n <title type=\"text\" />\n <updated>2009-11-29T06:06:57Z</updated>\n <author>\n <name />\n </author>\n <link rel=\"edit\" title=\"SampleEntity\" href=\"Data(3)\" />\n <category term=\"WebApplication69.SampleEntity\" scheme=\"http://schemas.microsoft.com/ado/2007/08/dataservices/scheme\" />\n <content type=\"application/xml\">\n <m:properties>\n <d:ID m:type=\"Edm.Int32\">3</d:ID>\n <d:Name>Name3</d:Name>\n </m:properties>\n </content>\n </entry>\n <entry>\n <id>http://localhost:4321/WebDataService1.svc/Data(4)</id>\n <title type=\"text\" />\n <updated>2009-11-29T06:06:57Z</updated>\n <author>\n <name />\n </author>\n <link rel=\"edit\" title=\"SampleEntity\" href=\"Data(4)\" />\n <category term=\"WebApplication69.SampleEntity\" scheme=\"http://schemas.microsoft.com/ado/2007/08/dataservices/scheme\" />\n <content type=\"application/xml\">\n <m:properties>\n <d:ID m:type=\"Edm.Int32\">4</d:ID>\n <d:Name>Name4</d:Name>\n </m:properties>\n </content>\n </entry>\n <entry>\n <id>http://localhost:4321/WebDataService1.svc/Data(5)</id>\n <title type=\"text\" />\n <updated>2009-11-29T06:06:57Z</updated>\n <author>\n <name />\n </author>\n <link rel=\"edit\" title=\"SampleEntity\" href=\"Data(5)\" />\n <category term=\"WebApplication69.SampleEntity\" scheme=\"http://schemas.microsoft.com/ado/2007/08/dataservices/scheme\" />\n <content type=\"application/xml\">\n <m:properties>\n <d:ID m:type=\"Edm.Int32\">5</d:ID>\n <d:Name>Name5</d:Name>\n </m:properties>\n </content>\n </entry>\n </feed>Для того, чтобы все-таки передавать это значение на клиент достаточно вспомнить, что значение перечисляемого типа — это, по сути, целое число, а это простой тип, который можно передавать через сервис. Таким образом, делаем небольшое дополнение к этой сущности и получаем следующее её определение.
\n[DataServiceKey(\"ID\")]\n[IgnoreProperties(\"State\")]\npublic class SampleEntity\n{\n public int ID { get; set; }\n\n public string Name { get; set; }\n\n public int StateValue { get; set; }\n\n public StateEnum State\n {\n get { return (StateEnum)StateValue; }\n set { StateValue = (int)value; }\n }\n}После этого, сервис, работающий с указанной сущностью будет игнорировать свойство State, но при этом на клиент будет передаваться StateValue. В этом легко убедиться, если обратиться к сервису через браузер.
<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\" ?>\n<feed xml:base=\"http://localhost:4321/WebDataService1.svc/\" xmlns:d=\"http://schemas.microsoft.com/ado/2007/08/dataservices\" xmlns:m=\"http://schemas.microsoft.com/ado/2007/08/dataservices/metadata\" xmlns=\"http://www.w3.org/2005/Atom\">\n <title type=\"text\">Data</title>\n <id>http://localhost:4321/WebDataService1.svc/Data</id>\n <updated>2009-11-29T06:13:47Z</updated>\n <link rel=\"self\" title=\"Data\" href=\"Data\" />\n <entry>\n <id>http://localhost:4321/WebDataService1.svc/Data(1)</id>\n <title type=\"text\" />\n <updated>2009-11-29T06:13:47Z</updated>\n <author>\n <name />\n </author>\n <link rel=\"edit\" title=\"SampleEntity\" href=\"Data(1)\" />\n <category term=\"WebApplication69.SampleEntity\" scheme=\"http://schemas.microsoft.com/ado/2007/08/dataservices/scheme\" />\n <content type=\"application/xml\">\n <m:properties>\n <d:ID m:type=\"Edm.Int32\">1</d:ID>\n <d:Name>Name1</d:Name>\n <d:StateValue m:type=\"Edm.Int32\">1</d:StateValue>\n </m:properties>\n </content>\n </entry>\n <entry>\n <id>http://localhost:4321/WebDataService1.svc/Data(2)</id>\n <title type=\"text\" />\n <updated>2009-11-29T06:13:47Z</updated>\n <author>\n <name />\n </author>\n <link rel=\"edit\" title=\"SampleEntity\" href=\"Data(2)\" />\n <category term=\"WebApplication69.SampleEntity\" scheme=\"http://schemas.microsoft.com/ado/2007/08/dataservices/scheme\" />\n <content type=\"application/xml\">\n <m:properties>\n <d:ID m:type=\"Edm.Int32\">2</d:ID>\n <d:Name>Name2</d:Name>\n <d:StateValue m:type=\"Edm.Int32\">2</d:StateValue>\n </m:properties>\n </content>\n </entry>\n <entry>\n <id>http://localhost:4321/WebDataService1.svc/Data(3)</id>\n <title type=\"text\" />\n <updated>2009-11-29T06:13:47Z</updated>\n <author>\n <name />\n </author>\n <link rel=\"edit\" title=\"SampleEntity\" href=\"Data(3)\" />\n <category term=\"WebApplication69.SampleEntity\" scheme=\"http://schemas.microsoft.com/ado/2007/08/dataservices/scheme\" />\n <content type=\"application/xml\">\n <m:properties>\n <d:ID m:type=\"Edm.Int32\">3</d:ID>\n <d:Name>Name3</d:Name>\n <d:StateValue m:type=\"Edm.Int32\">1</d:StateValue>\n </m:properties>\n </content>\n </entry>\n <entry>\n <id>http://localhost:4321/WebDataService1.svc/Data(4)</id>\n <title type=\"text\" />\n <updated>2009-11-29T06:13:47Z</updated>\n <author>\n <name />\n </author>\n <link rel=\"edit\" title=\"SampleEntity\" href=\"Data(4)\" />\n <category term=\"WebApplication69.SampleEntity\" scheme=\"http://schemas.microsoft.com/ado/2007/08/dataservices/scheme\" />\n <content type=\"application/xml\">\n <m:properties>\n <d:ID m:type=\"Edm.Int32\">4</d:ID>\n <d:Name>Name4</d:Name>\n <d:StateValue m:type=\"Edm.Int32\">1</d:StateValue>\n </m:properties>\n </content>\n </entry>\n <entry>\n <id>http://localhost:4321/WebDataService1.svc/Data(5)</id>\n <title type=\"text\" />\n <updated>2009-11-29T06:13:47Z</updated>\n <author>\n <name />\n </author>\n <link rel=\"edit\" title=\"SampleEntity\" href=\"Data(5)\" />\n <category term=\"WebApplication69.SampleEntity\" scheme=\"http://schemas.microsoft.com/ado/2007/08/dataservices/scheme\" />\n <content type=\"application/xml\">\n <m:properties>\n <d:ID m:type=\"Edm.Int32\">5</d:ID>\n <d:Name>Name5</d:Name>\n <d:StateValue m:type=\"Edm.Int32\">1</d:StateValue>\n </m:properties>\n </content>\n </entry>\n</feed>Последнее, что осталось сделать — это сообщить клиентской библиотеке о том, как воспринимать подобные значения. Для этого на клиентской стороне также объявим нужный перечисляемый тип, в частичном классе добавим нужное свойство и укажем атрибут IgnoreProperties.
public enum StateEnum\n{\n Normal = 1,\n Error = 2\n}\n\n[IgnoreProperties(\"State\")]\npublic partial class SampleEntity\n{\n public StateEnum State\n {\n get { return (StateEnum)StateValue; }\n set { StateValue = (int)value; }\n }\n}Теперь на клиентской стороне можно обращаться к нужному свойству и получать значение перечисляемого типа. При этом сервис будет работать корректно.
\nclass Program\n{\n static void Main(string[] args)\n {\n var context = new MyDataContext(new Uri(@\"http://localhost:4321/WebDataService1.svc/\"));\n foreach (var entity in context.Data)\n {\n Console.WriteLine(entity.State);\n }\n Console.Read();\n }\n}![\"Использование](\"https://blog.zwezdin.com/2009/adonet-data-services-enums/fb0edd99/2@2x.png\")
\n\n\n\n\nКонечно, представленное решение не претендует на элегантное решение. Однако, если сильно хочется использовать перечисляемые типы, то это может быть одним из решений, которое можно использовать в приложениях.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2009/adonet-data-services-enums/021f9f98/adonet_data-services-enums@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/wcf-progress-bar/", "url": "https://blog.zwezdin.com/2009/wcf-progress-bar/", "title": "Отображение прогресса загрузки данных в сервисах WCF", "date_published": "2009-11-04T13:00:00.000Z", "content_html": "Платформу Windows Communication Foundation можно использовать не только для простого вызова операций, но и для передачи большого объема данных (например, файлов в несколько мегабайт). Иногда такие сценарии применимы и на медленных каналах. В последнем случае зачастую очень не хватает индикатора выполнения операции (progress bar). Когда-то давно я задавался такой задачей, но довести ее до реализации не хватило времени. Лучше поздно, чем никогда. Поэтому сегодня я предлагаю рассмотреть способ реализации прогресса выполнения на базе WCF.
Для простоты мы будем использовать привязку BasicHttpBinding. Поскольку протокол HTTP не имеет принципиальный противоречий для отображение прогресса выполнения, то этот способ нам подойдет. Ключевым моментом при реализации данного сценария является установка параметра TransferMode и привязки в значение Streamed. Таким образом, данные будут передаваться в виде потока.
После этого определим контракт взаимодействия клиента и сервера. На клиентскую сторону требуется передать имя файла, его размер и содержимое. Поэтому определим контракт следующим образом.
\n[ServiceContract]\npublic interface IFileTransferService\n{\n [OperationContract]\n RemoteFileInfo DownloadFile(DownloadRequest request);\n}\n\n[MessageContract]\npublic class DownloadRequest\n{\n [MessageBodyMember]\n public string FileName;\n}\n\n[MessageContract]\npublic class RemoteFileInfo : IDisposable\n{\n [MessageHeader(MustUnderstand = true)]\n public string FileName;\n\n [MessageHeader(MustUnderstand = true)]\n public long Length;\n\n [MessageBodyMember(Order = 1)]\n public Stream FileByteStream;\n\n public void Dispose()\n {\n if (FileByteStream != null)\n {\n FileByteStream.Close();\n FileByteStream = null;\n }\n }\n}Как видно, операция DownloadFile возвращает объект RemoteFileInfo, который содержит необходимую информацию. Реализация данного сервиса, я думаю, вопросов не вызывает — для этого нужно создать объект RemoteFileInfo и заполнить его всеми необходимыми данными.
public class FileTransferService : IFileTransferService\n{\n public RemoteFileInfo DownloadFile(DownloadRequest request)\n {\n var filePath = request.FileName;\n var fileInfo = new FileInfo(filePath);\n\n if (fileInfo.Exists==false)\n {\n throw new FileNotFoundException(\"File not found\", request.FileName);\n }\n\n var stream = new FileStream(filePath, FileMode.Open, FileAccess.Read);\n\n var result = new RemoteFileInfo\n {\n FileName = request.FileName,\n Length = fileInfo.Length,\n FileByteStream = stream\n };\n\n return result;\n }\n}На этом с серверной стороны мы сделали все необходимое, осталось только сформировать конфигурационный файл и определить хост-среду для сервиса. Для простоты в качестве хоста будем использовать консольное приложение. Тогда код для размещения сервиса будет выглядеть следующим образом.
\nclass Program\n{\n static void Main()\n {\n var myServiceHost = new ServiceHost(typeof(FileService.FileTransferService));\n myServiceHost.Open();\n\n Console.ReadKey();\n\n myServiceHost.Close();\n }\n}При этом конфигурационный файл будет иметь следующий вид.
\n<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<configuration>\n <system.serviceModel>\n <bindings>\n <basicHttpBinding>\n <binding name=\"FileTransferServicesBinding\"\n transferMode=\"Streamed\"\n messageEncoding=\"Mtom\"\n maxReceivedMessageSize=\"20134217728\" />\n </basicHttpBinding>\n </bindings>\n <services>\n <service behaviorConfiguration=\"MyServiceTypeBehaviors\"\n name=\"FileService.FileTransferService\">\n <endpoint address=\"getfile\"\n binding=\"basicHttpBinding\"\n bindingConfiguration=\"FileTransferServicesBinding\"\n contract=\"FileService.IFileTransferService\" />\n <host>\n <baseAddresses>\n <add baseAddress=\"http://localhost/\" />\n </baseAddresses>\n </host>\n </service>\n </services>\n <behaviors>\n <serviceBehaviors>\n <behavior name=\"MyServiceTypeBehaviors\">\n <serviceMetadata httpGetEnabled=\"true\" />\n <serviceDebug includeExceptionDetailInFaults=\"true\" />\n </behavior>\n </serviceBehaviors>\n </behaviors>\n </system.serviceModel>\n</configuration>Теперь самое время заняться клиентской частью. Во-первых, определим конфигурацию для данного сервиса.
\n<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<configuration>\n <system.serviceModel>\n <bindings>\n <basicHttpBinding>\n <binding name=\"fileBinding\" maxReceivedMessageSize=\"20134217728\"\n messageEncoding=\"Mtom\" transferMode=\"Streamed\" />\n </basicHttpBinding>\n </bindings>\n <client>\n <endpoint address=\"http://localhost/getfile\"\n binding=\"basicHttpBinding\"\n bindingConfiguration=\"fileBinding\"\n contract=\"Client.FileTransferClient.IFileTransferService\" />\n </client>\n </system.serviceModel>\n</configuration>После генерации клиентского прокси он выглядит следующим образом.
\n[System.Diagnostics.DebuggerStepThroughAttribute()]\n[System.CodeDom.Compiler.GeneratedCodeAttribute(\"System.ServiceModel\", \"3.0.0.0\")]\npublic partial class FileTransferServiceClient :\n System.ServiceModel.ClientBase<Client.FileTransferClient.IFileTransferService>,\n Client.FileTransferClient.IFileTransferService\n{\n public FileTransferServiceClient()\n {\n }\n\n public FileTransferServiceClient(string endpointConfigurationName) :\n base(endpointConfigurationName)\n {\n }\n\n public FileTransferServiceClient(string endpointConfigurationName, string remoteAddress) :\n base(endpointConfigurationName, remoteAddress)\n {\n }\n\n public FileTransferServiceClient(string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress) :\n base(endpointConfigurationName, remoteAddress)\n {\n }\n\n public FileTransferServiceClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress) :\n base(binding, remoteAddress)\n {\n }\n\n Client.FileTransferClient.RemoteFileInfo Client.FileTransferClient.IFileTransferService.DownloadFile(Client.FileTransferClient.DownloadRequest request)\n {\n return base.Channel.DownloadFile(request);\n }\n}Как мы помним, операция сервиса DownloadFile возвращает информацию о файле и его поток. В этом виде не очень удобно работать с операцией, поэтому создадим еще один перегруженный вариант.
public long DownloadFile(ref string fileName, out System.IO.Stream fileByteStream)\n{\n Client.FileTransferClient.DownloadRequest inValue = new Client.FileTransferClient.DownloadRequest();\n inValue.FileName = FileName;\n Client.FileTransferClient.RemoteFileInfo retVal = ((Client.FileTransferClient.IFileTransferService)(this)).DownloadFile(inValue);\n FileName = retVal.FileName;\n FileByteStream = retVal.FileByteStream;\n return retVal.Length;\n}Таким образом, мы получили метод, который немедленно возвращает длину файла и его содержимое в виде потока (Stream). Теперь мы должны получить этот поток и считывать из него информацию порциями. При этом после каждого считывания необходимо обновлять информацию о прогрессе передачи данных. Полученные данные можно записывать, например, в локальный файл.
var client = new FileTransferClient.FileTransferServiceClient();\n\nStream inputStream;\nlong length = client.DownloadFile(ref fileName, out inputStream);\n\nusing (var writeStream = new FileStream(fileName, FileMode.CreateNew, FileAccess.Write))\n{\n const int bufferSize = 2048;\n var buffer = new byte[bufferSize];\n\n do\n {\n int bytesRead = inputStream.Read(buffer, 0, bufferSize);\n if (bytesRead == 0)\n {\n break;\n }\n\n writeStream.Write(buffer, 0, bytesRead);\n\n progressBar1.Value = (int)(writeStream.Position * 100 / length);\n }\n while (true);\n\n writeStream.Close();\n}\n\ninputStream.Dispose();\nclient.Close();Отлично, теперь мы получили приложение, которое будет отображать прогресс загрузки данных на клиент. Аналогичным образом можно сделать загрузку данных на сервер.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2009/wcf-progress-bar/49ea074c/wcf_progress-bar@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/wcf-throttling/", "url": "https://blog.zwezdin.com/2009/wcf-throttling/", "title": "Балансировка нагрузки в WCF (throttling)", "date_published": "2009-11-01T13:00:00.000Z", "content_html": "Платформа Windows Communication Foundation используется практически в каждом проекте, требующим использования сетевых сервисов. Фактически, если в проекте стает необходимость исопльзовать сервисы, мы несомненно используем WCF непосредственно или опосредовано (например, используя ADO.NET Data Services). Обычно сервисы работают что называется “из коробки” и многие не заботятся о дополнительном конфигурировании сервиса. Однако, при построении сервисов, которые должны работать под нагрузкой приходится задумываться о более сложных параметрах.
\nЗдесь я бы хотел в компактном виде привести основные сведения, которые нужно знать при настройке сервиса, работающего под нагрузкой.
\nConcurrencyModeПараметр, который определяет режим работы сервиса – сколько реальных потоков будут обрабатывать сообщения и выполнять действия. Этот параметр может принимать значения:
\nSingle – сообщения обрабатываются последовательно в единственном потоке (значение по умолчанию).Reentrant – аналогично Single с некоторыми ньюансами (см. MSDN).Multiple – сообщения обрабатываются параллельно в нескольких потоках.Также с этим параметром тесно связан параметр MaxConcurrentCalls, который ограничивает максимальное количество потоков обработки конкурирующих вызовов. Обычно параметр ConcurrencyMode задается при определении сервиса.
[ServiceBehavior(ConcurrencyMode = ConcurrencyMode.Multiple)]\npublic class Service1 : IService1\n{\n public string GetData(int value)\n {\n return string.Format(\"You entered: {0}\", value);\n }\n\n public CompositeType GetDataUsingDataContract(CompositeType composite)\n {\n if (composite.BoolValue)\n {\n composite.StringValue += \"Suffix\";\n }\n return composite;\n }\n}InstanceContextModeОчень важный параметр, который определяет каким способом создается объект на стороне сервиса для обслуживания запроса. Параметр может принимать следующие значения:
\nPerCall – создавать новый экземпляр сервиса на каждый вызов (значение по умолчанию).PerSession – создавать новый экземпляр сервиса на каждую сессию.Single – создавать единственный экземпляр сервиса, который будет обслуживать все запросы.Понятно, что более эффективно использовать режим Single. При этом будет создан единственный объект сервиса и не нужно заботиться об использовании памяти и других ресурсов. Однако, в случаях, когда сервис содержит состояние, использовать режим Single невозможно. В этом случае можно ограничить количество одновременно существующих экземпляров сервиса параметром MaxConcurrentInstances. Также можно ограничить количество одновременно работающих сессий, это делается при помощи параметра MaxConcurrentSessions.
Обычно параметр InstanceContextMode задается при определении сервиса.
[ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)]\npublic class Service1 : IService1\n{\n public string GetData(int value)\n {\n return string.Format(\"You entered: {0}\", value);\n }\n\n public CompositeType GetDataUsingDataContract(CompositeType composite)\n {\n if (composite.BoolValue)\n {\n composite.StringValue += \"Suffix\";\n }\n return composite;\n }\n}Кроме того, на параметры устойчивости приложения на внешние атаки могут влиять параметры, задающие квоты на различные параметры. Например, к таким квотам относятся настройки sendTimeout, receiveTimeout, maxReceivedMessageSize и т.д. Более подробно о них можно прочитать в MSDN.
Мы продолжаем рассматривать новые возможности ADO.NET Data Services 1.5 и сегодня мы посмотрим возможность принудительной разбивки данных на страницы.
\nВ первой версии Astoria возможность разбивки данных на страницы уже присутствовала. Для этих целей можно было построить запрос с помощью конструкций Take/Skip. Изменяя значения этих параметров можно было получить постраничный доступ к данным с клиента. Тем не менее, при обращении к коллекции без параметров сервис возвращал полностью всю коллекцию. Описанное поведение кажется вполне логичным, но оно не всегда является желательным. К примеру, если в коллекции содержится большое количество объектов, то обращение к такой коллекции непременно повлечет повышенную нагрузку на сервер, а клиент получит задержку при обращении к сервису. Поэтому в версии 1.5 было принято решение о добавлении возможности принудительной разбивки на страницы.
Для включения описанной возможности необходимо определить дополнительное поведение при конфигурировании сервиса. В частности нам необходим метод SetEntitySetPageSize(), который позволяет определить размер страницы для каждой коллекции. Этот метод принимает два параметра — имя коллекции и размер страницы. Если необходимо определить размер для всех коллекций, то в качестве имени коллекции необходимо использовать *.
public class WebDataService : DataService<NorthwindEntities>\n{\n public static void InitializeService(DataServiceConfiguration config)\n {\n config.SetEntitySetAccessRule(\"*\", EntitySetRights.All);\n\n config.DataServiceBehavior.MaxProtocolVersion = DataServiceProtocolVersion.V2;\n config.SetEntitySetPageSize(\"Categories\", 5);\n }\n}В случае описанного выше сервиса, при обращении к коллекции Categories данные будут разбиты на страницы по пять объектов. При этом в конце результирующего набора данных будет выдана подсказка, позволяющая обратиться к следующей страницы набора данных.
![\"ADO.NET](\"https://blog.zwezdin.com/2009/adonet-data-services-paging/1f73235f/1@2x.png\")
\n\n\n\n\nКак видно, для обращения к следующей странице необходимо использовать ключевое слово skiptoken. В этом случае формат URI будет выглядеть следующим образом:
http://.../WebDataService.svc/Categories?$skiptoken=5Данная функциональность также поддерживается и в рамках клиентского прокси. При обычном обращении к коллекции клиенту будет выдано только указанное число объектов. Для обращения к остальным страницам необходимо использовать метод Skip().
var client = new NorthwindEntities(new Uri(@\"...\"));\nvar q = from c in client.Categories.Skip(2)\n select c;\n\nforeach (var item in q)\n{\n // ...\n}При таком подходе мы также можем использовать всю функциональность сервисов данных – фильтрация, сортировка, проекции и т.д. При этом количество записей на странице будет всегда ограничиваться указанным значением.
\nОднако, несмотря на привлекательность данной возможности, не стоит прибегать к частым ее использованием. В случае, если нет особой надобности в подобной разбивке на странице, то лучше этого не делать, поскольку разбивка на страницы несомненно ведет к увеличению числа запросов к сервису для получения одного и того же набора данных.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2009/adonet-data-services-paging/ca3d742f/adonet_data-services-paging@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/adonet-data-services-projections/", "url": "https://blog.zwezdin.com/2009/adonet-data-services-projections/", "title": "ADO.NET Data Services 1.5: проекции", "date_published": "2009-09-15T12:00:00.000Z", "content_html": "Недавно я начал тему, посвященную ADO.NET Data Services 1.5. Ранее я рассказал о общих тенденциях в этом проекте. Настало время поделиться некоторыми деталями. Здесь мы рассмотрим возможность создания проекций с помощью нового функционала, который появится в версии 1.5.
\nНеобходимость создания проекций присутствовала еще в первой версии Astoria. Однако, как мы знаем, время и ресурсы ограничены, поэтому такая возможность появилась только в версии 1.5. Возможность создания проекций необходима в тех ситуациях, когда сущности, содержащиеся в коллекциях на сервисе содержат большое количество полей, а клиенту нужны только некоторые поля. В этом случае клиент вынужден загружать все поля этих объектов и тем самым генерировать лишний трафик и увеличивая время выполнения запросов.
\nВ версии 1.0 предлагалось решить проблему путем разделения большой сущности на несколько маленьких и работать с ними отдельно. В этом случае, если необходимо все-таки получить доступ ко всем полям объекта создавалось представление (View), которое существовало в рамках сервиса в виде отдельной коллекции или сервисной операции. Безусловно, такой подход создает массу проблем. Например, в такой ситуации требуется приложить дополнительные усилия в случае редактирования таких коллекций. Кроме того, количество коллекций данных на сервисе может существенно увеличиться. В этом случае напрашивается логичное решение - “попросить” у сервиса вернуть не все поля объектов, а только те, которые необходимо прямо в URI.
В этом и заключается сущность работы механизма проекций в ADO.NET Data Services 1.5. Всякий раз, когда необходимо вернуть специфичный набор полей, мы задаем его явно в URI. При этом остальные поля игнорируются и не передаются клиенту.
\nДля выполнения подобного запроса появилось новое ключевое слово select. Например, если необходимо выбрать два поля ProductName и UnitPrice, то необходимо выполнить следующий запрос:
http://../WebDataService.svc/Products()?$select=ProductName,UnitPriceАналогично, если необходимо выбрать все поля, проигнорировав этот оператор или указав в качестве значения *:
http://../WebDataService.svc/Products()?$select=*В некоторых ситуациях возможность получения проекций может быть нежелательна. В этом случае её можно отключить, используя дополнительные параметры конфигурирования сервиса. Для этого в классе DataServiceConfiguration появилось свойство DataServiceBehavior, которое позволяет настраивать поведение сервиса. В данном случае нас интересует свойство AcceptProjectionRequests.
public class WebDataService : DataService<NorthwindEntities>\n{\n public static void InitializeService(DataServiceConfiguration config)\n {\n config.SetEntitySetAccessRule(\"*\", EntitySetRights.All);\n\n config.DataServiceBehavior.AcceptProjectionRequests = true;\n config.DataServiceBehavior.MaxProtocolVersion = DataServiceProtocolVersion.V2;\n }\n}При использовании клиентского прокси возможность создания проекций также можно использовать удобным образом. Для этого нужно построить запрос, где в секции Select указать необходимые поля.
var client = new NorthwindEntities(new Uri(@\"http://.../WebDataService.svc/\"));\nvar q = from c in client.Categories\n select new { c.CategoryName, c.Description };В этом случае также будет генерироваться запрос с оператором select в URI.
Кроме того, Astoria 1.5 решает еще одну проблему. Если клиенту необходимо обратиться к сервису для получения количества объектов в коллекции, то в ранних версиях было необходимо обратиться к сервису, получить сущности и посчитать их. Это могло существенно увеличивать трафик и время загрузки. В Astoria 1.5 появился дополнительный оператор count, который позволяет вычислить количество сущностей в рамках данного запроса на стороне сервиса. Для этого необходимо выполнить следующий запрос:
http://.../WebDataService.svc/Products()/$countБолее того, если необходимо выполнить какой-то запрос (например, фильтрацию) и получить количество записей, то это также возможно. Для этого мы обращаемся к подобному URI, а затем указываем параметры запроса:
\nhttp://.../WebDataService.svc/Products()/$count?$filter=CategoryId gt 5С точки зрения клиентского прокси, подобные URI будут генерироваться при вызове метода-расширения Count().
var client = new NorthwindEntities(new Uri(@\"http://localhost:1076/WebDataService.svc/\"));\nvar с = (from c in client.Categories\n where c.CategoryID > 5\n select c).Count();Возможность подсчета количества сущностей в запросе также может быть отключена при настройке сервиса. Это можно сделать, используя свойство AcceptCountRequests.
public class WebDataService : DataService<NorthwindEntities>\n{\n public static void InitializeService(DataServiceConfiguration config)\n {\n config.SetEntitySetAccessRule(\"*\", EntitySetRights.All);\n\n config.DataServiceBehavior.AcceptCountRequests = true;\n config.DataServiceBehavior.AcceptProjectionRequests = true;\n config.DataServiceBehavior.MaxProtocolVersion = DataServiceProtocolVersion.V2;\n }\n}Подобной функциональности очень нехватало в первой версии ADO.NET Data Services и сейчас она была добавлена. И теперь мы можем использовать сервисы еще более эффективно.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2009/adonet-data-services-projections/96d32528/adonet_data-services-projections@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part3/", "url": "https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part3/", "title": "Windows 7 Sensor and Location platform - реализация поддержки собственного сенсора (Часть 3/3)", "date_published": "2009-07-02T12:00:00.000Z", "content_html": "Я рассказал о том, как можно использовать Sensor and Location platform в своих приложениях. Мы увидели, что использование этого набора компонент может быть очень удобным для приложения и не требует много усилий. Также мы получаем возможность работы с множеством устройств в унифицированном виде. Единственной проблемой использования этой платформы остается наличие драйверов для Windows 7 и наличие оберток для Sensor API. Разработка драйвера для устройства – задача производителя, в первую очередь. А вот реализацию поддержки в Sensor API вполне можно сделать собственными силами. Здесь мы и займемся этим.
\nКак я уже говорил точкой входа является класс SensorManager. С помощью этого класса можно получить доступ к нужным сенсорам и поработать с ними. Этот класс имеет такие методы как получение списка всех сенсоров, получение сенсора по ID или по типу, запрос на использование сенсора, а также событие изменения количества сенсоров в системе.
![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part3/056f822a/1@2x.png\")
\n\n\n\n\nКаждый сенсор имеет два основных типа идентификаторов – SensorId и TypeId. TypeId идентифицирует отдельный класс устройств. Например, по нему можно получить все датчики света в системе, или какие-то другие типы устройств. SensorId присваивается уникально каждому устройству. Например, если в системе три однотипных датчика движений, то каждый будет иметь уникальный идентификатор. Есть еще также CategoryId, который объединяет сенсоры в категории.
Каждый идентификатор представляет собой GUID. Они задаются производителями при разработке устройства и драйверов. Таким образом, можно получить конкретный сенсор только зная его ID. Каждый сенсор представлен классом Sensor. Он имеет общую информацию о сенсоре и методы, которые позволяют получить данные из обобщенных коллекций в нетипизированном виде. Понятно, что такое представление данных не очень удобно для наших приложений. Поэтому для каждого сенсора принято реализовывать класс-обертку в рамках Sensor API. Реализуется она путем наследования от общего класса Sensor. В демонстрационных примерах уже есть две такие реализации – для акселерометра и для датчика света. Однако, в устройстве, которое мы рассматривали ранее присутствуют также сенсорные кнопки, которые также можно использовать. Поэтому давайте реализуем такой класс для этого датчика.
Мы определим новый класс, который будет наследником класса Sensor. Для того, чтобы он распознавался в Sensor API его нужно пометить атрибутом SensorDescription, в котором указать TypeId для этого типа сенсоров. В базовом классе Sensor существуют две важные вещи для нас – свойство DataReport и событие DataReportChanged. Это свойство содержит данные от сенсора, а событие срабатывает при их изменении. Задача нашего класса – воспользоваться этими данными и доставить их пользователю нашего класса в удобном виде. Для этого создадим еще один небольшой класс, который будет заниматься разбором информации из DataReport.
Экспериментальным путем мы выясним, что при нажатии кнопки 1 генерируется код 1, при нажатии 2 – генерируется код 2, при нажатии 3 – генерируется код 4, а при нажатии 4 – генерируется код 8. Видно, что здесь используются просто двоичные разряды. Также генерируется код 0 в случае отпускания всех кнопок. Таким образом, мы можем написать следующий код.
\n[SensorDescription(\"545C8BA5-B143-4545-868F-CA7FD986B4F6\")]\npublic class SwitchArraySensor : Sensor\n{\n public class SwitchArraySensorData\n {\n private static Guid KeyStateProperyId = new Guid(@\"38564a7c-f2f2-49bb-9b2b-ba60f66a58df\");\n\n public SwitchArraySensorData(SensorReport report)\n {\n uint state = (uint) report.Values[KeyStateProperyId][0];\n Button1Pressed = (state & 0x01) != 0;\n Button2Pressed = (state & 0x02) != 0;\n Button3Pressed = (state & 0x04) != 0;\n Button4Pressed = (state & 0x08) != 0;\n }\n\n public bool Button1Pressed { get; private set; }\n public bool Button2Pressed { get; private set; }\n public bool Button3Pressed { get; private set; }\n public bool Button4Pressed { get; private set; }\n }\n\n public SwitchArraySensorData Current\n {\n get { return new SwitchArraySensorData(DataReport); }\n }\n\n public event EventHandler StateChanged;\n\n public SwitchArraySensor()\n {\n DataReportChanged += SwitchArraySensor_DataReportChanged;\n }\n\n void SwitchArraySensor_DataReportChanged(Sensor sender, EventArgs e)\n {\n if (StateChanged != null)\n {\n StateChanged.Invoke(sender, e);\n }\n }\n}Фактически, этот класс является оберткой в Sensor API для нужного нам сенсора. Для его использования я должен подписаться на событие StateChanged и получать информацию через свойство Current.
Для получения списка доступных сенсоров заданного типа можно использовать метод GetSensorsByTypeId класса SensorManager. При этом TypeId этих сенсоров будет определяться исходя из заданного атрибута SensorDescription. Теперь, используя эти сенсоры мы можем подписаться на нужные событие и получать данные в удобном для приложения виде. Например, можем отображать на форме состояние нажатия кнопок.
private void Window_Loaded(object sender, RoutedEventArgs e)\n{\n var sensors = SensorManager.GetSensorsByTypeId<SwitchArraySensor>();\n foreach (SwitchArraySensor sensor in sensors)\n {\n switch (sensor.FriendlyName)\n {\n case \"Left Switch Array Sensor\":\n sensor.StateChanged += delegate(object leftSensor, EventArgs arg)\n {\n var buttons = ((SwitchArraySensor)leftSensor).Current;\n SwitchState(LeftButton1, buttons.Button1Pressed);\n SwitchState(LeftButton2, buttons.Button2Pressed);\n SwitchState(LeftButton3, buttons.Button3Pressed);\n SwitchState(LeftButton4, buttons.Button4Pressed);\n };\n break;\n case \"Right Switch Array Sensor\":\n sensor.StateChanged += delegate(object rightSensor, EventArgs arg)\n {\n var buttons = ((SwitchArraySensor)rightSensor).Current;\n SwitchState(RightButton1, buttons.Button1Pressed);\n SwitchState(RightButton2, buttons.Button2Pressed);\n SwitchState(RightButton3, buttons.Button3Pressed);\n SwitchState(RightButton4, buttons.Button4Pressed);\n };\n break;\n }\n }\n}В итоге получим приложение, которое выглядит следующим образом.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part3/ecdbb3ae/2@2x.png\")
\n\n\n\n\nКонечно, пример с реализацией подобного сенсора достаточно синтетический. Однако, он явно демонстрирует процесс подключения датчика к Sensor API.
", "tags": [ "Internet of Things", "Windows" ], "banner_image": "https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part3/bf8319bb/windows7_sensor-and-location-platform-part3@cover.png" }, { "id": "https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/", "url": "https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/", "title": "Windows 7 Sensor and Location platform - программирование сенсоров (Часть 2/3)", "date_published": "2009-07-01T12:00:00.000Z", "content_html": "Недавно я писал о том, что такое Sensor and Location platform в Windows 7 и зачем она нужна. Сейчас мы поговорим о том, каким образом эту платформу можно использовать в своих приложениях.
\nДля того, чтобы проводить эксперименты не с виртуальными датчиками, а с чем-то более-менее приближенным к реальности, мы будем использовать устройство от Freescale semiconductor, построенное на базе микроконтроллера JMBADGE2008-B. Это устройство представляет собой небольшую плату, на которой также есть несколько датчиков – акселерометр, датчик света и кнопки.
![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/7b98289f/1@2x.png\")
\n\n\n\n\nЭто устройство разработано специально для демонстрации возможностей Sensor and Location platform в Windows 7. Фактически, каждый может купить его. Таким образом, это устройство хорошо подходит для того, чтобы продемонстировать эту возможность Windows 7.
\nПрежде чем рассматривать конкретные приложения, давайте посмотрим на то, как устроена платформа Sensor and Location. До появления Windows 7 и Sensor&Location platform подключение различных датчиков сводилось к реализации драйвера и программного обеспечения к нему.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/a7598ecf/2@2x.png\")
\n\n\n\n\nПри такой организации задачи взаимодействия с внешними датчиками можно, но тяжело. Для этого каждое приложение должно взаимодействовать с тем API, которое предложит разработчик датчика и программного обеспечения, которое обслуживает этот датчик. Проблема встает особенно остро в случае, если приложение должно использовать множество однотипных датчиков от разных производителей. Как эту проблему предлагает решить Sensor&Location platform?
\nНа уровне операционной системы присутствуют механизмы работы с датчиками. Существует стандартный унифицированный программный интерфейс для работы с датчиками – Sensor API. При этом все взаимодействия с датчиком происходят именно через Sensor API. Важно, что взаимодействия со всеми датчиками происходит в едином стиле. Теперь вам не нужно интегрироваться с native API через p/invoke.
![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/8c2cd41b/3@2x.png\")
\n\n\n\n\nДля того, чтобы работать с Sensor and Location API необходимо загрузить соответствующую библиотеку .NET Interop Sample Library. В ней существуют .NET-обертки для работы с Sensor API. В нем существует несколько классов, при помощи которых можно работать с датчиками.
\nКласс SensorManager является точкой входа. Через него можно получить информацию о сенсорах, а также поработать с ними. Например, при помощи метода GetSensorBySensorId<> можно получить доступ к интересующему нас датчику. Каждый датчик должен иметь класс-обертку, который наследуется от базового класса Sensor. В .NET Interop Sample Library уже существуют три таких реализации – AmbientLightSensor, Accelerometer3D, UnknownSensor.
![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/25d62557/4@2x.png\")
\n\n\n\n\nОсновная идея при работе с датчиками заключается в следующем. При изменении состояния датчика (подключен/отключен/активен/итд) генерируется событие StateChanged. Это событие необходимо для начала или прекращения работы с датчиками. После того, как связь с датчиком налажена, при получении новых данных генерируется событие DataReportChanged. Насколько часто будет генерироваться это событие зависит от реализации датчика и драйвера к нему. При обработке этого события можно считать состояние датчиков и каким-то образом изменить работу приложения. Для этих целей используется метод GetProperty. В параметрах этого метода передается идентификатор свойства, которое нужно считать от датчика. Как правило, детали вызовов этого метода скрываются в классах, которые реализуются для специфичного датчика.
Кроме того, каждый датчик имеет собственный идентификатор (GUID), по которому можно идентифицировать устройство. При реализации класса-обертки для датчика этот ID указывается при помощи атрибута. Таким образом, доступ к датчику можно получить как явно указав идентификатор этого датчика, так и сославшись на этот класс-обертку.
/// <summary>\n/// Represents a generic ambient light sensor\n/// </summary>\n[SensorDescription( \"97F115C8-599A-4153-8894-D2D12899918A\" )]\npublic class AmbientLightSensor : Sensor\n{\n\n// .....\n// .....\n// .....\n\nvar sensors = SensorManager.GetSensorsByTypeId<AmbientLightSensor>();Давайте попробуем реализовать несколько примеров работы с датчиками, которые доступны в устройстве от Freescale. Мы будем работать с двуми типами датчиков – акселерометром (позволяет измерять угол наклона устройства) и датчиком света (измеряет уровень освещенности в помещении).
\nПервое приложение, которое мы реализуем будет отображать уровень освещенности в виде горящей лампочки на форме. Для начала подпишемся на событие изменения состояния в Sensor API. Это необходимо для того, чтобы приложение начало работать, если датчик подключен на ходу. В обработчике этого события мы получим список всех датчиков нужного типа и подпишемся у них на событие DataReportChanged. В обработчике этого события мы будем считывать значение с датчика освещенности и записывать его в TextBox на форме. Т.к. событие генерируется в дополнительном потоке, также потребуется сделать вызов метода Dispatcher.Invoke, чтобы обработка шла в основном потоке и мы могли взаимодействовать с элементами на форме. Таким образом получим следующий код.
private void Window_Loaded(object sender, RoutedEventArgs e)\n{\n SensorManager.SensorsChanged += SensorManagerSensorsChanged;\n}\n\nvoid SensorManagerSensorsChanged(SensorsChangedEventArgs change)\n{\n Dispatcher.Invoke((System.Threading.ThreadStart)(UpdateSensorsList));\n}\n\nprivate void UpdateSensorsList()\n{\n var sensors = SensorManager.GetSensorsByTypeId<AmbientLightSensor>();\n foreach (var sensor in sensors)\n sensor.DataReportChanged += delegate(Sensor sender, EventArgs e)\n {\n Dispatcher.Invoke((System.Threading.ThreadStart)(delegate\n {\n if (ActiveSensorsListBox.SelectedItem == sender)\n {\n CurrentValue.Text =\n ((AmbientLightSensor)sender).CurrentLuminousIntensity.Intensity.ToString();\n }\n }));\n };\n}Теперь в TextBox на форме выводится текущее значение освещенности. Теперь нетрудно реализовать какую-то визуализацию для этого. При помощи привязок в WPF будем отображать степень освещенности в виде лампочек. В итоге получим следующее приложение.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/64b11bb3/5@2x.jpg\")
\n\n\n\n\n\n\n\n ![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/3e75c79c/6@2x.jpg\")
\n\n\n\n\nДругой датчик более интересен – он позволяет определять степень наклона устройства по разным осям. Для демонстрации степени наклона мы возьмем трехмерную модель самолета для WPF приложения и будем вращать ее в пространстве в зависимости от показателей датчика. Принцип этого приложения аналогичен предыдущему – мы находим нужные датчики, подписываемся на события и при их обработке записываем координаты в поля ввода на форме. После этого привязываем координаты модели к значениям этих полей ввода.
\nprivate void UpdateSensorsList()\n{\n foreach (var sensor in SensorManager.GetSensorsByTypeId<Accelerometer3D>())\n {\n sensor.DataReportChanged += delegate(Sensor sender, EventArgs e)\n {\n Dispatcher.Invoke((System.Threading.ThreadStart)(delegate\n {\n if (UseXCoordinate.IsChecked == true)\n CurrentXValue.Text = ((Accelerometer3D)sender).CurrentAcceleration[Accelerometer3D.AccelerationAxis.X].ToString();\n if (UseYCoordinate.IsChecked == true)\n CurrentYValue.Text = ((Accelerometer3D)sender).CurrentAcceleration[Accelerometer3D.AccelerationAxis.Y].ToString();\n if (UseZCoordinate.IsChecked == true)\n CurrentZValue.Text = ((Accelerometer3D)sender).CurrentAcceleration[Accelerometer3D.AccelerationAxis.Z].ToString();\n }));\n };\n }\n}Как видно из этого примера, код для работы с датчиками изменился не очень сильно. Фактически, изменился только код получения данных от датчиков, а остальное осталось неизменным.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/b99b0221/7@2x.jpg\")
\n\n\n\n\n\n\n\n ![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/ff6b80d6/8@2x.jpg\")
\n\n\n\n\n\n\n\n ![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/df5f552f/9@2x.jpg\")
\n\n\n\n\nЧто интересно, эти датчики могут использовать несколько приложений одновременно. Также в одном приложении можно использовать несколько датчиков. Давайте совместим приложение с вращением трехмерной модели с датчиком света. В этом случае кроме поворота модели будем показывать солнце. Если освещенность в помещении снижается, то и солнце будет скрываться. Чем больше освещения в помещении, тем солнце будет светить интенсивнее. Соответственно в этом приложении используется код из двух предыдущих примерах. Поэтому я не буду приводить код, а сразу покажу результат.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/c0d98a04/10@2x.jpg\")
\n\n\n\n\n\n\n\n ![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/6787dbc2/11@2x.jpg\")
\n\n\n\n\n\n\n\n ![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/5802a04b/12@2x.jpg\")
\n\n\n\n\nНа этих примерах хорошо видно, что работа с датчиками в Windows 7 является очень простой. Однако, для этого необходимо иметь драйвер для Windows 7 и класс-обертку для Sensor&Location platform. Как правило, драйвера поставляются самим производителем аппаратной платформы, а вот класс-обертку можно реализовать самостоятельно. В следующий раз мы поговорим как раз на эту тему.
", "tags": [ "Internet of Things", "Windows" ], "banner_image": "https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part2/6daac7a3/windows7_sensor-and-location-platform-part2@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part1/", "url": "https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part1/", "title": "Windows 7 Sensor and Location platform - что это такое? (Часть 1/3)", "date_published": "2009-06-15T12:00:00.000Z", "content_html": "Одна из составных частей Windows 7 – Sensor and Location platform. Sensor and Location – это часть Windows 7, которая позволяет организовать работу с различными датчиками и дополнительными устройствами для измерения чего-либо.
\nЗачем это нужно? Датчики нужны для того, чтобы упросить некоторые тривиальные действия и избавить нас от лишних забот в работе. Особенно актуально это для владельцев ноутбуков, чья жизнь является очень динамичной. Представьте себе, что в компьютер встроен датчик освещения, который доступен для всех приложений и дает возможность этим приложениям корректировать свою картинку в зависимости от освещения. Другим примером может являться датчик GPS-координат. В этом случае приложения могут подстраиваться под ту местность, где вы в данный момент находитесь. Например, приложения могут отображать информацию о погоде именно для того города, где вы находитесь. На самом деле примеров можно привести большое количество, все зависит от фантазии и конкретных случаев. Приложения, которые изменяют свое поведение в зависимости от внешних условий выделяются в отдельный класс приложений и называются контекстно-зависимыми приложениями.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part1/4abdd553/1@2x.jpg\")
\n\n\n\n\nМожет возникнуть вопрос – “а что, собственно, изменилось?”, “почему этого нельзя было сделать раньше?”. Ответ прост – ранее эти сценарии также можно было реализовать. Но сделать это было не так просто. Фактически, работа с внешними датчиками сводилась к обмену информацией через COM-порт и каждый датчик имел свой специфический API. По этой причине было очень тяжело организовать какой-то универсальный программный интерфейс, с которым можно было работать одновременно из нескольких приложений и этот процесс был бы прозрачен.
\nИменно эту проблему решает библиотека Sensor and Location. С ее помощью можно обращаться к различными датчикам и получать от них информацию в едином для всех стилей. Важно, что эта проблема решается на уровне операционной системы. Такой шаг может дать новый толчок для развития контекстно-зависимых приложений. Далее приведена диаграмма, отображающая структуру объектов для работы с датчиками. В следующих частях мы рассмотрим это подробнее.
\n\n\n\n![\"Windows](\"https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part1/5e943628/2@2x.png\")
\n\n\n\n\nДля подключения датчика к Sensor and Location platform в Windows 7 необходимо реализовать для него драйвер и несложные классы-обертки на .NET для работы с этим датчиком.
\nБезусловно, в ближайшее время конечные пользователи вряд ли смогут в полной мере ощутить мощь всей этой платформы. Для этого потребуется некоторое время, чтобы разработчики аппаратного обеспечения могли разработать и встроить свои датчики в аппаратные платформы. Однако, нам, разработчикам, можно начинать готовиться к этому уже сегодня. Поэтому далее я планирую рассказать о том, каким образом работать с Sensor and Location platform в контексте наших бизнес-приложений.
", "tags": [ "Internet of Things", "Windows" ], "banner_image": "https://blog.zwezdin.com/2009/windows7-sensor-and-location-platform-part1/9e1674fd/windows7_sensor-and-location-platform-part1@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/windows7-taskbar-wpf/", "url": "https://blog.zwezdin.com/2009/windows7-taskbar-wpf/", "title": "Работа с панелью задач Windows 7 в приложениях WPF", "date_published": "2009-06-13T12:00:00.000Z", "content_html": "Не так давно я опубликовал серию статей, посвященных возможностям Windows 7 для разработчиков при работе с панелью задач. За это время я получил огромное количество откликов, за что огромное вам спасибо. Что интересно, вопросы были совершенно различного характера. Однако, большая часть вопросов была на тему использования подобной функциональности в приложениях на базе WPF. Действительно, в большинстве примеров я упустил из вида WPF приложения. Это упущение я постараюсь компенсировать здесь.
\nВ реальности, использование этих возможностей в приложениях WPF не сильно отличается от их реализации в WinForms. Как известно, для использование возможностей панели задач Windows 7 мы пользовались статическим классом WindowsFormsExtensions, в котором содержаться методы-расширения для класса Form (представление формы в Windows Forms). К сожалению, в .NET Interop Sample Library нет подобного класса для WPF приложений. Однако совсем не сложно создать его самостоятельно.
\nЕсли взглянуть на класс WindowsFormsExtensions внимательно, то становится понятно, что все вызовы перенаправляются классу Windows7Taskbar, который для идентификации формы используется Handle окна, с которым производится работа. В случае с Windows Forms у формы есть свойство Handle, которое возвращает нужное значение. Соответственно первая задача – это получить handle окна Windows Presentation Foundation. К сожалению, у окон WPF нет свойства Handle. Однако, можно воспользоваться услугами класса WindowInteropHelper и получить эту информацию. Для этого я сделал еще один метод, который возвращает Handle WPF-окна.
private static IntPtr GetWindowHandle(Window window)\n{\n return (new WindowInteropHelper(window)).Handle;\n}Далее во всех методах-расширениях необходимо изменить тип параметра (тип, к которому применяется extension method) с From на Window. После этого большинство возможностей уже доступны для WPF-приложений.
\nДругим ньюансом при работе с панелью задач Windows 7 является то, что в некоторых ситуациях требуется перехватывать сообщения Windows, которые приходят к текущему окну. В Windows Forms для этих целей можно было переопределить метод WndProc и в нем отлавливать все нужные сообщения.
protected override void WndProc(ref Message m)\n{\n if (m.Msg == Windows7Taskbar.TaskbarButtonCreatedMessage)\n {\n // ...\n }\n\n base.WndProc(ref m);\n}К сожалению, для окон WPF такого метода нет. Однако, в WPF приложениях можно воспользоваться объектом HwndSource и добавить перехват сообщений Windows через него.
private void Window_Loaded(object sender, RoutedEventArgs e)\n{\n HwndSource.FromHwnd(new WindowInteropHelper(this).Handle).AddHook(WndProc);\n}\n\nprivate IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)\n{\n if (msg == WM_DWMSENDICONICLIVEPREVIEWBITMAP)\n {\n // ...\n }\n return IntPtr.Zero;\n}В остальном использование возможностей панели задач Windows 7 в приложениях WPF реализуется аналогично Windows Forms.
", "tags": [ "WPF" ], "banner_image": "https://blog.zwezdin.com/2009/windows7-taskbar-wpf/c81274ce/windows7_taskbar-wpf@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/windows7-federated-search/", "url": "https://blog.zwezdin.com/2009/windows7-federated-search/", "title": "Интеграция ваших источников данных с федеративным поиском Windows 7", "date_published": "2009-06-11T12:00:00.000Z", "content_html": "Как часто вам приходится искать различную информацию? Скорее всего это происходит каждый день. Нужно отметить, что задача поиска информации далеко не тривиальная. Ситуация осложняется тем, что информация может находится в совершенно различных источниках – в файлах, в сообщениях электронной почты, в документах и т.д. Не секрет, что большая часть информации находится в сети – локальной и глобальной.
\nДля упрощения поиска информации в Windows Vista был разработан инструмент Windows Search, который позволяет легко и удобно искать информацию на основе заранее подготовленных индексов. В Windows 7 тема поиска нашла свое продолжение и в новой операционной системе появился инструмент Windows 7 Federated Search.
\nWindows 7 Federated Search – это инструмент, который позволяет искать информацию в сети на основе Windows Explorer. В качестве источника данных в этом случае может выступать все что угодно – корпоративный сайт, интернет-магазин, интернет-аукционы и т.д.
\nОтличие федеративного поиска от Windows Search заключается в том, что механизмы федеративного поиска не индексируют источники данных, а просто обращаются к ним с просьбой выполнить поисковый запрос. Федеративный поиск ориентирован именно на распределенные удаленные источники информации. Когда речь идет об удаленных источниках, их индексация может быть неэффективной и привести к излишнему расходу трафика. Именно поэтому выбран подход, при котором задача обработки поискового запроса ложится на плечи удаленного источника. Таким образом, появляется возможность подключить все удаленные источники и выполнять поиск по ним не выходя из привычного Windows Explorer.
\nНесмотря на все удобство такого поиска, реализация провайдера поиска является очень простой задачей. Федеративный поиск в Windows 7 базируется на стандарте OpenSearch 1.1 и работает следующим образом. Для выполнения поиска Windows 7 обращается к внешему веб-сервису, построенному на базе REST-подхода. Это означает, что искомая строка, а также другие данные, необходимые для поиска, передаются в URI при обращении к этому веб-сервису. Веб-сервис на основе этих данных должен выполнить поиск в своем источнике данных и вернуть результат в формате RSS или AtomPub. После этого Windows 7 представит результаты поиска из полученных данных в виде файлов и отобразит их пользователю.
\nДля добавления своего провайдера поиска в Windows 7 необходимо создать файл описания этого провайдера. Формат этого файла базируется на XML и содержит информацию о данном сервисе поиска, в т.ч. формат URI для обращения к сервису.
\n\n\n\n![\"Интеграция](\"https://blog.zwezdin.com/2009/windows7-federated-search/8fa2b946/1@2x.png\")
\n\n\n\n\nТаким образом, для реализации собственного провайдера федеративного поиска в Windows 7 необходимо выполнить два несложных действия – создать REST-сервис для поиска информации и сделать для него файл описания.
\nДавайте рассмотрим процесс создания провайдера поиска на следующем примере. Имеется список книг с описанием, автором и другой информацией. В данном случае этот список содержится в файле XML (для демонстрационного примера). В качестве источника данных можно использовать все что угодно. Сделаем провайдер поиска по этому списку.
\nФайл описания провайдера поиска представляет собой XML-файл и имеет расширение .osdx. Этот файл имеет следующую структуру.
<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<OpenSearchDescription xmlns=\"http://a9.com/-/spec/opensearch/1.1/\">\n <ShortName>Federated Search sample provider</ShortName>\n <Url type=\"application/rss+xml\" template=\"http://somehost.com/search/?q={searchTerms}&start={startIndex}&count={count}\" />\n</OpenSearchDescription>В секции Url этого файла задается шаблон адреса, который будет использоваться при обращении к веб-сервису. Видно, что этот адрес может принимать совершенно различный вид. В шаблоне адреса используется несколько секций, в которые будут подставляться значения. Главная секция – это секция searchTerms. В эту секцию будет подставляться строка для поиска. Федеративный поиск Windows 7 получает данные постранично, поэтому существуют секции count и startIndex, которые задают размер и номер страницы. Это необходимо для, того, чтобы Windows смогла получить первые результаты поиска, отобразить их пользователю, а затем заняться остальными элементами.
В демонстрационном примере будет создан веб-сервис, который будет размещен на локальной машине. По этой причине файл описания провайдера поиска будет иметь следующий вид.
\n<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n<OpenSearchDescription xmlns=\"http://a9.com/-/spec/opensearch/1.1/\">\n <ShortName>Federated Search sample provider</ShortName>\n <Url type=\"application/rss+xml\" template=\"http://localhost:8731/FederatedSearchProviderSample/search/{searchTerms}/?start={startIndex}&count={count}\" />\n</OpenSearchDescription>Последнее, что необходимо сделать – это создать сам сервис, который будет выполнять поиск. В этом случае нет привязки к конкретной технологии и единственное требование – сервис должен возвращать результат в формате RSS/Atom. Понятно, что сам сервис может быть построен на совершенно различных платформах и технологиях. Это может быть PHP, Ruby, Native CGI и т.д. Если рассматривать набор технологий для построения REST-сервисов от Microsoft, то лучший в данном случае выбор – использование возможностей WCF для построения REST-сервисов. Построению подобных сервисов уже уделено немало внимания, поэтому я не буду подробно останавливаться на этом, а опишу лишь ключевые шаги.
\nПервое, что необходимо сделать — это определить контракт. В контракте будут присутствовать две операции — выполнения поиска и получения детальной информации.
\n[ServiceContract]\n[ServiceKnownType(typeof(Atom10FeedFormatter))]\n[ServiceKnownType(typeof(Rss20FeedFormatter))]\npublic interface ISearchProvider\n{\n [OperationContract]\n [WebGet(UriTemplate = \"search/{searchTerms}/*\")]\n SyndicationFeedFormatter Search(string searchTerms);\n\n [OperationContract]\n [WebGet(UriTemplate = \"details/{id}\")]\n Stream Description(string id);\n}Самое главное, на что нужно обратить внимание в этот момент – определение шаблона URI. Как видно в данном случае шаблон search/{searchTerms}/* полностью соответствует тому, что был определен в файл описания.
Остается только реализовать этот сервис. При реализации необходимо учитывать указанные параметры при обращении к сервису (searchTerms, start, count) и разбивать результат поиска на страницы, если это необходимо. Для этого идеально подходят методы LINQ - Take/Skip. Таким образом, реализация сервиса будет выглядеть следующим образом.
public class SearchProvider : ISearchProvider\n{\n public SyndicationFeedFormatter Search(string searchTerms)\n {\n int count;\n int startIndex;\n\n int.TryParse(WebOperationContext.Current.IncomingRequest.UriTemplateMatch.QueryParameters.Get(\"count\"), out count);\n int.TryParse(WebOperationContext.Current.IncomingRequest.UriTemplateMatch.QueryParameters.Get(\"start\"), out startIndex);\n\n var result = SearchBooks(searchTerms);\n\n if (count > 0)\n {\n if (startIndex >= 0)\n {\n result = result.Skip(count * (startIndex - 1)).Take(count);\n }\n else\n {\n result = result.Take(count);\n }\n }\n\n return new Rss20FeedFormatter(\n new SyndicationFeed(\"Federated search sample\", String.Empty, null,\n from item in result\n select new SyndicationItem(item.Element(XName.Get(\"name\")).Value,\n item.Element(XName.Get(\"description\")).Value,\n new Uri(WebOperationContext.Current.IncomingRequest.UriTemplateMatch.BaseUri.ToString() + @\"/details/\" + item.Element(XName.Get(\"id\")).Value))\n {\n PublishDate = DateTimeOffset.Parse(item.Element(XName.Get(\"date\")).Value),\n }));\n }\n\n //...\n}Также в сервисе присутствуют методы для отображения детальной информации и выполнения поиска. При желании можно загрузить пример и посмотреть их реализацию там.
\nПосле того, как сервис готов и запущен, необходимо открыть файл описания сервиса (.osdx) в Windows и согласиться с предложением добавить провайдер поиска. После этого этот провайдер появится в общем списке провайдеров поиска.
![\"Интеграция](\"https://blog.zwezdin.com/2009/windows7-federated-search/226d4dae/2@2x.png\")
\n\n\n\n\n\n\n\n ![\"Интеграция](\"https://blog.zwezdin.com/2009/windows7-federated-search/6709afee/3@2x.png\")
\n\n\n\n\nТеперь, когда веб-сервис работает и провайдер поиска успешно добавлен, можно искать на сетевом ресурсе прямо из Windows Explorer. Кроме того, можно воспользоваться окном предварительного просмотра. По умолчанию в него загружается содержимое, которое расположено по адресу, на который ссылается данный пункт (в демонстрационном приложении – это /details/{id}). По этому адресу может быть расположено HTML-содержимое, которое будет отображаться пользователю.
![\"Интеграция](\"https://blog.zwezdin.com/2009/windows7-federated-search/62e9a150/4@2x.png\")
\n\n\n\n\nКак видно, реализация провайдера поиска для Windows 7 Federated Search является очень простой, однако, может сделать использование ваших данных намного удобней и проще. Одним из наиболее удачных примеров внедрения федеративного поиска по внешним источникам является провайдер поиска для корпоративных сайтов на базе Sharepoint. Почему бы и нам не реализовать подобную функциональность для своих приложений?
", "tags": [ "Tips&Tricks" ], "banner_image": "https://blog.zwezdin.com/2009/windows7-federated-search/d36af119/windows7_federated-search@cover.png" }, { "id": "https://blog.zwezdin.com/2009/windows7-taskbar-animations/", "url": "https://blog.zwezdin.com/2009/windows7-taskbar-animations/", "title": "Анимация переключения задач в Windows 7", "date_published": "2009-06-07T12:00:00.000Z", "content_html": "Среди круга пользователей Windows встречаются такие люди, которым не нужны плавные анимации при переключении окон, эффекты скрытия, полупрозрачности. Для таких пользователей важна скорость работы и удобство. Одним словом, то, что им нужно – отзывчивый интерфейс. Именно с таким пользователем совсем недавно мы общались по электронной почте. Его проблема заключалась в том, что при наведении на значок приложения в панели задач ему необходимо подождать какое-то время перед тем, как он увидит окно предварительного просмотра для приложения. По этой причине я решил написать пару советов для такой категории пользователей.
\nСитуация: при наведении на значок приложения окно предварительного просмотра появляется с задержкой.
\nКак ускорить анимацию:
\nПуск → Выполнить → regedit)HKEY_CURRENT_USER → Control Panel → MouseMouseHoverTime400 на 50 (время задержки анимации в миллисекундах)Ситуация: при сворачивании/разворачивании окон присутствует анимация, которая может мешать в работе. Если это справедливо для вашего случая, то ее можно отключить.
\nОтключение анимации:
\nControl Panel)System and Security, затем подраздел SystemAdvnced system settingsAdvanced, в группе Performance нажимаем кнопку SettingsAnimate windows when minimizing and maximizing![\"Анимация](\"https://blog.zwezdin.com/2009/windows7-taskbar-animations/cd20acd4/1@2x.png\")
",
"tags": [
"Tips&Tricks"
],
"banner_image": "https://blog.zwezdin.com/2009/windows7-taskbar-animations/923838bb/windows7_taskbar-animations@cover.jpg"
},
{
"id": "https://blog.zwezdin.com/2009/windows7-taskbar-part10/",
"url": "https://blog.zwezdin.com/2009/windows7-taskbar-part10/",
"title": "Программируем Windows 7: Taskbar. Часть 10 – JumpLists",
"date_published": "2009-06-01T12:00:00.000Z",
"content_html": "Одной из важнейших функций панели задач в Windows 7 являются Jump Lists. Jump lists отображаются, если выделить значок приложения в панели задач и нажать правую кнопку мыши. Если приложение использует функциональность JumpLists, то кроме стандартных действий (pin, close) появятся еще ряд дополнительных действий, которые облегчают нашу повседневную работу.
Этой функциональностью панели задач активно пользуются различные приложения. Например, Windows Media Player отображает опции переключения плейлистов. Internet Explorer и Windows Explorer содержат в jump lists с сылками на последние места, куда вы заходили. Windows Live Messanger отображает опции переключения состояния.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part10/311b1c34/1@2x.png\")
\n\n\n\n\nВ jump list могут присутствовать несколько различных типов элементов: задачи, ссылки на последние открытые документы и ссылки на постоянные документы. Кроме того, эти позиции могут быть закреплены. Такие элементы не исчезнут из jump list со временем. Это удобно, например, если мы часто работаем с одним и тем же документом. Схематично jump list можно представить следующим образом.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part10/7a035b01/2@2x.png\")
\n\n\n\n\nПо сути, каждый пункт в jump list представляет собой ссылку на программу или файл. Так, например, мы можем запустить калькулятор, или какой-либо документ заданного формата. К сожалению, у нас нет возможности напрямую перехватить событие нажатия на пункт в jump list. Каждый раз, когда мы выбираем очередной пункт будет запускаться новый экземпляр приложения. Это связано в первую очередь с тем, что jump list можно вызвать даже тогда, когда приложение не запущено. В этом случае оно должно быть закреплено (pinned) на панели задач. Например, на следующем рисунке видно, что Internet Explorer в данный момент не запущен, но jump list мы открыть можем.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part10/f19bd79c/3@2x.png\")
\n\n\n\n\nИтак, давайте посмотрим каким образом подобная функциональность может быть реализована в наших приложениях. Для работы с jump list нам понадобится объект типа JumpListManager, который входит в состав .NET Interop Sample Library. Создавать его необходимо в момент создания кнопки нашего приложения на панели задач. Для этих целей можно переопределить метод WndProc следующим образом.
\nprotected override void WndProc(ref Message m)\n{\n if (m.Msg == Windows7Taskbar.TaskbarButtonCreatedMessage)\n {\n _jumpListManager = WindowsFormsExtensions.CreateJumpListManager(this);\n _jumpListManager.UserRemovedItems += (o, e) =>\n {\n e.CancelCurrentOperation = false;\n };\n\n // add items\n\n _jumpListManager.Refresh();\n }\n\n base.WndProc(ref m);\n }Обратите внимание на вызов метода Refresh после создания объекта JumpListManager. Вызов этого метода необходим для обновления позиций в jump list. Также обязательным действием является подписка на событие UserRemovedItems. Оно исполняется когда производится попытка удаления устаревших пунктов из jump list. Давайте теперь попробуем добавить новые позиции в jump list. Для этих целей существуют классы-обертки и нужные методы у объекта JumpListManager.
Самый простой тип позиций в jump list – задачи. Задачей может быть запуск внешнего приложения или нашего приложения с какими-то параметрами. В WLM в виде задач реализовано переключение состояния пользователя. Для создания задачи в jump list используется метод AddUserTask.
_jumpListManager.AddUserTask(new ShellLink\n{\n Path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), \"calc.exe\"),\n Title = \"Calculator\",\n Category = \"Applications\",\n IconLocation = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), \"calc.exe\"),\n IconIndex = 0\n});Как видим, здесь создается новый объект типа ShellLink, в который передается путь до приложения, заголовок и значок. Я добавил в свое приложение две задачи и получил следующий результат.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part10/3d59a110/4@2x.png\")
\n\n\n\n\nДругой вариант заполнения jump list – ссылки на документы, которые были загружены ранее. Для этих целей я создал несколько текстовых файлов с расширением .myapp и ассоциировал этот тип файлов со своим приложением. При запуске приложения я проверяю передано ли имя файла в качестве параметра при запуске приложения. Если имя задано, то я считываю этот файл и добавляю его в список ранее загруженных файлов. Для этих целей существует метод AddToRecent.
if (File.Exists(Environment.GetCommandLineArgs().Skip(1).FirstOrDefault() ?? String.Empty) == true)\n{\n _jumpListManager.AddToRecent(Environment.GetCommandLineArgs().Skip(1).FirstOrDefault() ?? String.Empty);\n}Теперь из Windows Explorer я открою эти файлы. При этом будет запускаться мое демонстрационное приложение (если мы правильно ассоциировали данный тип файлов с приложением). При этом при вызове jump list я увижу, что в категории Recent появились ссылки на ранее открытые файлы.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part10/c1d96ae1/5@2x.png\")
\n\n\n\n\nЯ могу закрепить те позиции, с которыми я работаю чаще всего. В этом случае я смогу быстро открывать нужные мне документы через jump list.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part10/77defe65/6@2x.png\")
\n\n\n\n\nДругой способ размещения позиций в jump list – создание ссылок на постоянные документы/программы. В этом случае мы также можем сгруппировать эти позиции по категориям. Для этих целей существует метод AddCustomDestination.
_jumpListManager.AddCustomDestination(new ShellLink\n{\n Path = @\"about.txt\",\n Title = \"About\",\n Category = \"My application\",\n IconLocation = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.System), \"shell32.dll\"),\n IconIndex = 11\n});Я добавил несколько таких ссылок в jump list и получил следующий результат.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part10/bb129ef5/7@2x.png\")
\n\n\n\n\nНа этом рисунке видно, что появились две дополнительные группы со ссылками внутри.
\nЗамечательной особенностью jump list является то, что его содержимое также доступно в меню Пуск. Так, например, если мы активно пользуемся этой функциональностью, то это можно использоваться и из стартового меню.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part10/4dffd2e1/8@2x.png\")
\n\n\n\n\nТаким образом мы можем использовать дополнительную функциональность, которую нам предоставляет панель задач Windows 7 для обеспечения максимально комфортной работы пользователя.
", "tags": [ ".NET", "Windows", "Панель задач Windows 7" ], "banner_image": "https://blog.zwezdin.com/2009/windows7-taskbar-part10/75578584/windows7_taskbar-part10@cover.png" }, { "id": "https://blog.zwezdin.com/2009/windows7-taskbar-part9/", "url": "https://blog.zwezdin.com/2009/windows7-taskbar-part9/", "title": "Программируем Windows 7: Taskbar. Часть 9 – PeekBitmap", "date_published": "2009-05-29T12:00:00.000Z", "content_html": "Ранее я писал о возможности панели задач Windows 7 изменять preview для окна. Мы говорили о том, что в preview можно отображать как часть окна, так и собственное изображение. У Windows 7 есть такая приятная особенность, что если мы наведем курсор мыши на preview окна, то все остальные окна скроются, а выделенное окно будет отображаться. Выглядит это следующим образом.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part9/2c993106/1@2x.png\")
\n\n\n\n\nПанель задач Windows 7 в этом случае также позволяет нам задать собственное поведение. В этом случае мы имеем возможность задать содержимое нашей формы нашим собственным изображением. Например, там мы можем написать какой-то полезный текст. В этом случае сценарий работы может выглядеть следующим образом. У пользователя в панели задач находится приложение, которое что-то выполняет. Он может отслеживать его состояние на основе ProgressBar и OverlayIcon, о которых я писал ранее. Если этой информации ему недостаточно, он может навести курсор мыши на иконку приложение. В этом случае ему отобразится preview, в котором содержится дополнительная информация (о чем я тоже писал). Пользователь может навести на preview нужного окна и в этом случае все окна скроются и на экране останется только выделенное окно. В этом окне мы можем вывести еще больше информации, которая необходима пользователю.
Вообще, по умолчанию при таком сценарии при скрытии остальных окон выведется само содержимое окна. Переопределение содержания окна в этот момент может быть полезно, если на форме информация разрознена и сразу непонятно что происходит в приложении.
\nДля того, чтобы реализовать подобный сценарий в нашем приложении мы воспользуемся .NET Interop Sample Library. Для этих целей предназначен метод SetPeekBitmap класса-обертки. Генерировать изображение необходимо в момент времени, когда пользователь наводит на preview окна. Для этих целей переопределим метод WndProc и отловим событие WM_DWMSENDICONICLIVEPREVIEWBITMAP. Как раз в этот момент времени необходимо генерировать изображение.
protected override void WndProc(ref Message m)\n{\n if (m.Msg == WM_DWMSENDICONICLIVEPREVIEWBITMAP)\n {\n WindowsFormsExtensions.SetPeekBitmap(this, GeneratePeekBitmap(this, Images._111), true);\n }\n\n base.WndProc(ref m);\n}В данном случае мы вызываем метод, который будет генерировать нужный нам Bitmap. Генерация этого изображения также не представляет какой-либо сложности. В общем случае мы можем скопировать в этот Bitmap снимок нашего окна и поверх этого нарисовать нужную нам информацию. Давайте в демонстрационном приложении я заполню эту область неким фоном и нарисую значок состояния поверх этого.
private static Bitmap GeneratePeekBitmap(Form form, Image stateImage)\n{\n var preview = new Bitmap(form.ClientSize.Width, form.ClientSize.Height);\n\n var g = Graphics.FromImage(preview);\n\n g.DrawImage(Images.background.GetThumbnailImage(form.ClientSize.Width, form.ClientSize.Height, null, IntPtr.Zero), 0, 0);\n\n if (stateImage != null)\n {\n Size thumbSize = new Size(100, 100);\n g.DrawImage(stateImage.GetThumbnailImage(thumbSize.Width, thumbSize.Height, null, IntPtr.Zero), form.ClientSize.Width / 2 - thumbSize.Width / 2, form.ClientSize.Height / 2 - thumbSize.Height / 2);\n }\n\n return preview;\n}Обратите внимание, что для корректного отображения размеры этого изображения должны совпадать с размером формы. После этого у нас получится приложение, которое выглядит следующим образом.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part9/3619c7d5/2@2x.png\")
\n\n\n\n\nНа самом деле, после это изображение можно устанавливать откуда угодно. Главное, чтобы это изображение также генерировалось в момент обработки указанного выше события. Например, в демонстрационном приложении я также устанавливаю это изображение в таймере. Таким образом я могу навести курсор мыши на preview и наблюдать за тем как изменяется сама форма при срабатывании таймера.
\nКроме того, у метода SetPeekBitmap существует третий параметр логического типа (boolean). Изменяя этот параметр можно указать нужно ли убирать рамку приложения, когда осуществляется подобный просмотр. Например, если я установлю этот параметр в false, то увижу следующий результат.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part9/0a6caf9f/3@2x.png\")
",
"tags": [
".NET",
"Windows",
"Панель задач Windows 7"
],
"banner_image": "https://blog.zwezdin.com/2009/windows7-taskbar-part9/a99c0cdc/windows7_taskbar-part9@cover.png"
},
{
"id": "https://blog.zwezdin.com/2009/windows7-taskbar-part8/",
"url": "https://blog.zwezdin.com/2009/windows7-taskbar-part8/",
"title": "Программируем Windows 7: Taskbar. Часть 8 – IconicThumbnail",
"date_published": "2009-05-27T12:00:00.000Z",
"content_html": "Недавно я рассказал о том, каким образом можно влиять на preview окна в панели задач Windows 7. Тогда мы отображали только ту часть окна, которая наиболее важна для пользователя. Тем не менее в определенных ситуациях гораздо полезнее может быть отображение не части окна, а совершенно другая картинка, отображающая состояние приложения.
\nНапример, этой возможностью пользуется Windows Live Messanger. Если мы наведем курсор мыши на значок WLM, то во всплывающем окне он отобразит аватар текущего пользователя.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part8/b7098e80/1@2x.png\")
\n\n\n\n\nДавайте разберемся с этой возможностью панели задач Windows 7. Для реализации подобного поведения в .NET Interop Sample Library существует метод SetIconicThumbnail. Именно с его помощью мы можем легко и просто создать собственный preview для нашего окна. Однако, прежде чем мы начнем его использовать мы должны разрешить это поведение с помощью метода EnableCustomWindowPreview. В противном случае при выполнении метода SetIconicThumbnail мы получим соответствующее исключение. Сделать это можно прямо в конструкторе формы.
public Form1()\n{\n InitializeComponent();\n WindowsFormsExtensions.EnableCustomWindowPreview(this);\n}Стоит сказать, что размеры изображения, которое мы хотим отобразить в preview ограничены. Это логично, т.к. представьте что бы было, если preview могли бы быть размером 1024x768. Эти размеры ограничены значениями 200x120. Изображение может быть меньше этого размера, в этом случае само окно preview также будет уменьшено. Если изображение больше этих размеров, то будет сгенерировано исключение.
В параметрах метода SetIconicThumbnail передается ссылка на текущую форму и изображение (Bitmap), которое нужно отобразить. Наша задача – сгенерировать этот Bitmap. И в этом случае у нас полностью развязаны руки – мы можем сгенерировать все что нам угодно. Это может быть снимок окна, с каким-то дополнительным текстом поверх. Это может быть какая-то собственная картинка, содержащая информацию. Это может быть текст с некой статистикой. Все зависит от вашей фантазии.
В демонстрационном приложении я буду генерировать изображение, отображающее состояние приложение текстом и графически, а также небольшой снимок окна. Для этого я создам Bitmap нужных мне размеров и залью его фоном. После этого нарисую там изображение состояния и снимок окна. Затем я напишу на этом изображении текст состояния и результат передам в метод SetIconicThumbnail.
private static void SetState(Form form, string stateText, Image stateImage)\n{\n // blank image\n var preview = new Bitmap(200, 120);\n var g = Graphics.FromImage(preview);\n\n // fill background\n g.DrawImage(Images.background, 0, 0);\n\n // file image of state\n if (stateImage != null)\n {\n g.DrawImage(stateImage.GetThumbnailImage(100, 100, null, IntPtr.Zero), 100, 10);\n }\n\n // fill image of form\n g.DrawImage(GetFormImage(form, 50, 60), 10, 10);\n\n // draw text\n g.DrawString(stateText, new Font(\"Verdana\", 18), Brushes.White, 10, 70);\n\n // setting thumbnail\n WindowsFormsExtensions.SetIconicThumbnail(form, preview);\n}Как видим, код получился достаточно лаконичный. Как результат мы можем увидеть окно со следующим preview.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part8/a5154434/2@2x.png\")
\n\n\n\n\nЧто интересно, наше приложение может само в фоне изменять это состояние. При этом, если мышь находится на значке приложение и preview в данный момент отображается, то смена изображения во всплывающем окне происходит плавно, без каких-либо побочных эффектов. Так, например, я могу создать таймер, в обработчике которого через определенные промежутки времени изменять состояние.
\nprivate readonly string[] _stateTexts = new[] { \"Deleting..\", \"Wireless\", \"Security\", \"Stop\", \"Help\", \"O'kay\", \"Playing\", \"Login\", \"Warning\", \"Showcase\", \"Search\", \"Processing..\", \"Locked\", \"Error\", \"Refreshing..\" };\nprivate readonly Bitmap[] _stateImages = new[] { Images._104, Images._110, Images._111, Images._112, Images._113, Images._114, Images._120, Images._125, Images._129, Images._134, Images._17, Images._25, Images._41, Images._50, Images._52 };\nprivate int _currentIndex = 0;\n\nprivate void timer1_Tick(object sender, EventArgs e)\n{\n if (_currentIndex + 1 >= _stateImages.Length)\n {\n _currentIndex = 0;\n }\n else\n {\n _currentIndex++;\n }\n SetState(this, _stateTexts[_currentIndex], _stateImages[_currentIndex]);\n}![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part8/101bc11c/3@2x.png\")
\n\n\n\n\n\n\n\n ![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part8/eda328aa/4@2x.png\")
\n\n\n\n\n\n\n\n ![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part8/4501cc8d/5@2x.png\")
\n\n\n\n\nВ этом случае preview окна нашего приложения будет изменяться динамически, а пользователь может отслеживать это состояние легко и удобно.
", "tags": [ ".NET", "Windows", "Панель задач Windows 7" ], "banner_image": "https://blog.zwezdin.com/2009/windows7-taskbar-part8/f529cc8c/windows7_taskbar-part8@cover.png" }, { "id": "https://blog.zwezdin.com/2009/windows7-taskbar-part7/", "url": "https://blog.zwezdin.com/2009/windows7-taskbar-part7/", "title": "Программируем Windows 7: Taskbar. Часть 7 – ThumbnailClip", "date_published": "2009-05-26T12:00:00.000Z", "content_html": "Как мы уже видели, Windows 7 обладает удобной функциональностью по отображению preview окон приложений. При наведении мыши на значок окна в панели задач можно посмотреть уменьшенное представление окна за считанные секунды. Это очень удобно когда у пользователя открыто большое количество окон.
По умолчанию в этих preview отображается все содержимое окна. Однако, для некоторых приложений было бы гораздо удобнее показывать в preview не все содержимое окна, а только его часть. Такая функциональность также предусмотрена для панели задач Windows 7 и мы можем использовать ее для своих приложений. Давайте разберемся с этой возможностью панели задач Windows 7.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part7/47ac9be3/1@2x.png\")
\n\n\n\n\nКак обычно для этого будем использовать .NET Interop Sample Library. В рамках оберток для функций из системных библиотек Windows здесь присутствует метод SetThumbnailClip, который поможет нам в реализации данной функциональности. При вызове данного метода в параметрах необходимо передать текущий экземпляр формы и координаты, ограничивающие область окна.
private void Clip5_Click(object sender, EventArgs e)\n{\n WindowsFormsExtensions.SetThumbnailClip(this, new Rectangle(10, 10, 145, 145));\n}На этом примере хорошо видно, что использовать этот метод очень легко.
\nДавайте создадим небольшое приложение, где посмотрим на возможности этой функциональности. Для этого я создам пустое приложение, в которое добавлю несколько несколько элементов управления. После запуска приложения preview окна будет выглядеть следующим образом.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part7/1db27651/2@2x.png\")
\n\n\n\n\nВидно, что изначально в preview отображается все окно. Давайте ограничим область отображения при помощи метода SetThumbnailClip. Отобразим, например, только поля ввода, которые находятся на форме.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part7/95356155/3@2x.png\")
\n\n\n\n\nЧто интересно, если у нас на форме имеется динмический контент (например, видео), то он будет отображаться в динамике. В демонстрационном приложении я разместил несколько анимированных изображений и отобразил их в рамках preview. При этом нет необходимости для этого делать что-то еще.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part7/e360da65/4@2x.png\")
\n\n\n\n\n\n\n\n ![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part7/f9f962a8/5@2x.png\")
\n\n\n\n\nЧто важно, в процессе работы приложения мы можем изменять содержимое preview. Например, в какой-то момент времени нам может быть необходимо вывести содержимое какого-то важного поля ввода, а в другой момент - отобразить изображение с формы. Такая динамичность может дать пользователю возможность получать актуальную для него информацию.
Наконец если нам необходимо отобразить все содержимое формы можно использовать тот же самый метод, но передать ему размеры всей формы. В этом случае в preview снова будет отображаться все окно.
private void NoClip_Click(object sender, EventArgs e)\n{\n WindowsFormsExtensions.SetThumbnailClip(this, new Rectangle(new Point(0, 0), Size));\n}Недавно я писал о том, как можно организовать отображение вкладок для дочерних окон нашего приложения. В этом случае нам требовалось отобразить дочерние окна нашего приложения. Для этих целей мы пользовались классом CustomWindowManager.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part6/a17962bb/1@2x.png\")
\n\n\n\n\nТакого же эффекта можно добиться, если мы запустим несколько экземпляров одного и того же нашего приложения. В этом случае Windows 7 определит что это одно и то же приложение и сгруппирует окна в один значок.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part6/97a3b183/2@2x.png\")
\n\n\n\n\nДавайте попробуем разобраться как это работает. В основе всего лежит такое понятие как Application ID. Для каждого окна мы можем задать свой ID. Эту особенность также можно использовать тогда, когда необходимо избежать такого поведения. В этом случае нужно задать различные AppId для каждого такого окна. Сделать это можно используя .NET Interop Sample Library. Для этого необходимо вызвать метод SetAppId.
private void SetAppIdButton_Click(object sender, EventArgs e)\n{\n WindowsFormsExtensions.SetAppId(this, \"SomeAppId\");\n}Таким образом, мы можем задать различные AppId для каждого окна и они не будут группироваться.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part6/86edd4c5/3@2x.png\")
\n\n\n\n\nОднако, аналогичным образом также возможно сгруппировать несколько окон от разных приложений. Для этого необходимо задать одинаковый AppId для каждого из окон. И в этом случае панель задач Windows 7 сгруппирует эти приложения в один значок. Например, в данном случае я задал одинаковый AppId для разных окон из разных приложений и эти окна оказались сгруппированными в панели задач Windows 7.
",
"tags": [
".NET",
"Windows",
"Панель задач Windows 7"
],
"banner_image": "https://blog.zwezdin.com/2009/windows7-taskbar-part6/a11372ae/windows7_taskbar-part6@cover.png"
},
{
"id": "https://blog.zwezdin.com/2009/windows7-taskbar-part5/",
"url": "https://blog.zwezdin.com/2009/windows7-taskbar-part5/",
"title": "Программируем Windows 7: Taskbar. Часть 5 – CustomWindowsManager",
"date_published": "2009-05-21T12:00:00.000Z",
"content_html": "Мы продолжаем изучать возможности панели задач в Windows 7. Наверняка все вы обратили внимание на то, что если одно и то же приложение запустить несколько раз, Windows 7 автоматически сгруппирует их в одну кнопку на панели задач. Кроме того при наведении на значок этого приложения панель задач покажет набор preview для этих окон.
\nОднако, мы видим, что такое же поведение реализовано для открытых вкладок в Internet Explorer 8. В этом случае фактически запущен один экземпляр IE8 (технические детали мы опустим) и много вкладок. В этом случае Internet Explorer отображает их в виде нескольких preview. В данном случае это очень полезно, т.к. прямо из панели задач можно сразу переключиться на нужную вкладку.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part5/47914dd8/1@2x.png\")
\n\n\n\n\nКак можно догадаться, такую функциональность несложно реализовать и для своего приложения. Это актуально, если в вашем окне содержится набор других окон (как в случае с IE8). Для этих целей в .NET Interop Sample Library присутствует класс CustomWindowsManager. Давайте подробнее рассмотрим создание такого приложения.
\nИтак, для начала нам необходимо создать приложение. Пусть это приложение будет работать в режиме MDI. Наша цель – добиться того, чтобы все дочерние окна этого приложения также отображались в панели задач. После создания основного и дочернего окна давайте займемся последним.
\nНам необходим момент отображения окна, когда это окно уже создано и готово к работе. Очень хорошо для этих целей подходит событие OnShown. В обработчике мы должны создать экземпляр объекта CustomWindowsManager и передать ему Handle дочернего окна, а также родительского окна, с точки зрения модели MDI.
CustomWindowsManager _windowsManager;\n \nprotected override void OnShown(EventArgs args)\n{\n _windowsManager =\n CustomWindowsManager.CreateWindowsManager(Handle, MdiParent.Handle);\n\n base.OnShown(args);\n}Мы сохраним ссылку на объект CustomWindowsManager, она понадобится нам позже. Однако, этих действий недостаточно для корректной работы. Во-первых, мы должны подписаться на событие ThumbnailRequested, в котором сгенерировать Bitmap, содержащий отображение нашего окна для всплывающих окон в панели задач. Во-вторых, мы должны подписаться на событие PeekRequested, в котором сгенерировать Bitmap, содержащий отображения нашего окна для выделения его в момент наведения курсора мыши на preview окна в панели задач.
Событие ThumbnailRequested содержит параметр типа BitmapRequestedEventArgs. Этот объект будет управлять тем, что будет отображаться на панели задач. Самое простое, что мы можем сделать, это указать параметр UseWindowScreenshot равным true. В этом случае будет сделан скриншот окна без вашего участия. Если же хочется отобразить какую-то собственную картинку в preview окна, то можно воспользоваться параметром Bitmap, куда положить свой объект Bitmap, который должен быть отображен. Однако, нужно понимать, что этот объект должен иметь строго заданные размеры. Эти размеры мы также можем получить из BitmapRequestedEventArgs.
_windowsManager.ThumbnailRequested += (o, e) =>\n{\n Bitmap bmp = new Bitmap(e.Width, e.Height);\n this.DrawToBitmap(bmp, new Rectangle(0, 0, e.Width, e.Height));\n e.Bitmap = bmp;\n};Понятно, что здесь мы можем манипулировать этим объектом так как нам удобно. Например, можем наложить на preview нашу картинку.
_windowsManager.ThumbnailRequested += (o, e) =>\n{\n Bitmap bmp = new Bitmap(e.Width, e.Height);\n this.DrawToBitmap(bmp, new Rectangle(0, 0, e.Width, e.Height));\n Graphics.FromImage(bmp).DrawImage(Images.coffeecup, 35, 5);\n e.Bitmap = bmp;\n};Событие PeekRequested предназначено для того, чтобы выделить окно при наведении мыши на его preview в панели задач. Здесь также присутствует параметр типа BitmapRequestedEventArgs. Аналогичным образом можно использовать свойства UseWindowScreenshot и Bitmap.
_windowsManager.PeekRequested += (o, e) =>\n{\n var result = new Bitmap(e.Width, e.Height);\n DrawToBitmap(result, new Rectangle(0, 0, e.Width, e.Height));\n e.Bitmap = result;\n};Обратите внимание, что в этих примерах я использую метод DrawToBitmap формы. Однако, я могу выводить preview любого другого элемента управления. Например, я могу отображать TextBox.
Ну и, наконец, необходимо вызвать метод WindowClosed когда окно закрывается. Для этого хорошо подходит событие OnClosed.
protected override void OnClosed(EventArgs e)\n{\n if (_windowsManager != null)\n {\n _windowsManager.WindowClosed();\n }\n\n base.OnClosed(e);\n}После этого мы получили следующее приложение.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part5/3d1b6629/2@2x.png\")
\n\n\n\n\nЕсли мы посмотрим на панель задач, то увидим следующее.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part5/26de6474/3@2x.png\")
\n\n\n\n\nОднако, если мы начнем изменять внешний вид формы, то увидим, что preview не изменилось. Это вызвано тем, что Windows 7 не запрашивала событие получения preview. Это особенно критично, если на форме находится контент, который постоянно изменяется, например видео. В этом случае есть способ обновить preview принудительно. Для этого необходимо вызвать метод InvalidatePreviews.
private void InvalidateButton_Click(object sender, EventArgs e)\n{\n _windowsManager.InvalidatePreviews();\n}Этот метод в каждом конкретном случае надо вызывать в нужные моменты времени. Например, при обновлении текста в TextBox. Для видео хороший вариант – вызывать его по таймеру.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part5/c83df49d/4@2x.png\")
",
"tags": [
".NET",
"Windows",
"Панель задач Windows 7"
],
"banner_image": "https://blog.zwezdin.com/2009/windows7-taskbar-part5/7f7a52a1/windows7_taskbar-part5@cover.png"
},
{
"id": "https://blog.zwezdin.com/2009/windows7-taskbar-part4/",
"url": "https://blog.zwezdin.com/2009/windows7-taskbar-part4/",
"title": "Программируем Windows 7: Taskbar. Часть 4 – Custom OverlayIcon",
"date_published": "2009-05-19T12:00:00.000Z",
"content_html": "Ранее я писал о том, как можно добавить значок состояния для вашего приложения в панели задач Windows 7. Мы рассматривали статические изображения для этих целей. Напомню, что для этого мы использовали метод SetTaskbarOverlayIcon, в параметрах которого передается ссылка на Icon.
Однако, один из читателей блога предложил другой сценарий, в котором на месте дополнительной иконки отображается какая-то информация. К примеру, это может быть текущая скорость закачки, если ваше ПО что-то загружает по сети. Либо это может быть количество новых писем в почтовом ящике, если это почтовый клиент. Примеров можно много привести.
\nНапомню, что для того, чтобы задать статическое изображение необходимо выполнить следующий код.
\nWindowsFormsExtensions.SetTaskbarOverlayIcon(this, Icons.Error, \"Error\");В качестве второго параметра здесь передается объект Icon. Однако кто нам мешает генерировать этот объект динамически? Давайте воспользуемся нехитрым кодом и сделаем это. Я создам метод, который будет генерировать такое изображение и покажу эту иконку.
private static Icon BuildIcon(int param)\n{\n Bitmap image = Icons.BLANK2334242;\n Graphics.FromImage(image).DrawString(param.ToString(@\"D2\"), new Font(\"Arial\", 54), Brushes.White, 10, 25);\n return Icon.FromHandle(image.GetHicon());\n}\n\nprivate void ShowStatus(object sender, EventArgs e)\n{\n WindowsFormsExtensions.SetTaskbarOverlayIcon(this, BuildIcon(50, \"Status\");\n}Таким образом, при помощи метода BuildIcon будет сгенерирована новая иконка, которая будет отображена на панели задач.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part4/461f7e57/1@2x.png\")
\n\n\n\n\nНа данном скриншоте хорошо видно, что к стандартному значку мы добавили текст и отобразили это на панели задач.
\nВ демонстрационном приложении я создал таймер, который имитирует работу менеджера загрузки, выдавая постоянно разную “скорость” закачки.
", "tags": [ ".NET", "Windows", "Панель задач Windows 7" ], "banner_image": "https://blog.zwezdin.com/2009/windows7-taskbar-part4/4ab0568b/windows7_taskbar-part4@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/windows7-taskbar-part3/", "url": "https://blog.zwezdin.com/2009/windows7-taskbar-part3/", "title": "Программируем Windows 7: Taskbar. Часть 3 – OverlayIcon", "date_published": "2009-05-18T12:00:00.000Z", "content_html": "На этот раз мы поговорим о другой особенности панели задачи Windows 7 – OverlayIcon. Эта возможность исключительно полезна для приложений, которые обладают каким-то состоянием с точки зрения пользователя.
\nК таким приложениям можно отнести программы для обмена мгновенными сообщениями (IM). Например, Windows Live Messanger активно использует эту возможность. Например, если мы откроем WLM и будем изменять состояние, то можно увидеть как оно отображается на панели задач.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part3/a745d492/1@2x.png\")
\n\n\n\n\n\n\n\n ![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part3/e4bbbb59/2@2x.png\")
\n\n\n\n\n\n\n\n ![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part3/3310b94c/3@2x.png\")
\n\n\n\n\nТакая функциональность может быть полезна для множества приложений. К счастью реализовать ее не так сложно. Как и в предыдущих примерах мы воспользуемся библиотекой .NET Interop Sample Library.
\nЧтобы добавить иконку состояния к основному значку приложения, необходимо добавить файл ресурсов в проект и разместить там нужные иконки. Также, мы можем получить объекты Icon из другого места, если это необходимо.
![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part3/bac0ba4a/4@2x.png\")
\n\n\n\n\nТеперь все, что необходимо сделать – это воспользоваться методами расширения, позволяющими задавать иконки для нашего приложения. Для этих целей определен метод SetTaskbarOverlayIcon. Мы должны передать ему в параметрах нашу форму, иконку и описание. Т.о., установка новой иконки из кода будет выглядеть следующим образом.
WindowsFormsExtensions.SetTaskbarOverlayIcon(this, Icons.Error, \"Error\");Также мы можем удалить этот значок. Для этого необходимо передать значение null вместо самой иконки.
WindowsFormsExtensions.SetTaskbarOverlayIcon(this, null, String.Empty);Давайте создадим для примера небольшое приложение, в котором можем переключать состояние. Выглядеть оно будет следующим образом.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part3/4c84e2e6/5@2x.png\")
\n\n\n\n\nПри нажатии на каждую из кнопок переключается состояние, которое отображается в панели задач.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part3/ce36ad99/6@2x.png\")
\n\n\n\n\n\n\n\n ![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part3/6934bb8b/7@2x.png\")
\n\n\n\n\n\n\n\n ![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part3/96141433/8@2x.png\")
\n\n\n\n\n\n\n\n ![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part3/0e1ff239/9@2x.png\")
\n\n\n\n\n\n\n\n ![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part3/c3c9554b/10@2x.png\")
",
"tags": [
".NET",
"Windows",
"Панель задач Windows 7"
],
"banner_image": "https://blog.zwezdin.com/2009/windows7-taskbar-part3/d370086f/windows7_taskbar-part3@cover.jpg"
},
{
"id": "https://blog.zwezdin.com/2009/windows7-taskbar-part2/",
"url": "https://blog.zwezdin.com/2009/windows7-taskbar-part2/",
"title": "Программируем Windows 7: Taskbar. Часть 2 - ThumbButtons",
"date_published": "2009-05-08T12:00:00.000Z",
"content_html": "Недавно я рассказывал о том, как в Windows 7 можно отображать прогресс выполнения операции прямо в панели задач Windows. На этот раз мы продолжим разговаривать про возможности Windows 7 для программиста и рассмотрим возможность добавления собственных кнопок управления в preview окна.
\nПодобную функциональность вы уже могли заметить при использовании Windows 7. Например, подобные кнопки существуют для Windows Media Player. Они позволяют переключать треки, а также останавливать воспроизведение. Всего таких кнопок можно создать не более семи.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part2/c84245cb/1@2x.png\")
\n\n\n\n\nНесомненно, такая функциональность может быть полезна не только для Media Player, но и для наших приложений. Давайте посмотрим как можно реализовать это в нашем приложении.
\nКак я уже говорил, для всех системных функций Windows 7 существует обертка на .NET, которая называется .NET Interop Sample Library. Мы пользовались услугами этой библиотеки когда управляли состоянием progress bar. Сейчас мы также воспользуемся этой библиотекой.
\nСоздание наших кнопок должно происходить в момент обработки события WM_TaskbarButtonCreated. Поэтому в форме необходимо переопределить метод WndProc и обрабатывать моменты появления этого события.
\nprotected override void WndProc(ref Message m)\n{\n if (m.Msg == Windows7Taskbar.TaskbarButtonCreatedMessage)\n {\n // initialize buttons\n }\n\n base.WndProc(ref m);\n}Для инициализации кнопок необходим объект ThumbButtonManager. Этот объект управляет поведением и отображением этих кнопок. Этот объект можно создать, используя метод расширения CreateThumbButtonManager. После этого необходимо воспользоваться методом CreateThumbButton и создать объект кнопки. После того, как все кнопки будут созданы необходимо добавить их на панель задач при помощи метода AddThumbButtons.
protected override void WndProc(ref Message m)\n{\n if (m.Msg == Windows7Taskbar.TaskbarButtonCreatedMessage)\n {\n InitializeThumbButtons();\n }\n\n base.WndProc(ref m);\n}\n\nprotected void InitializeThumbButtons()\n{\n ThumbButtonManager thumbButtonManager =\n WindowsFormsExtensions.CreateThumbButtonManager(this);\n\n var decreaseThumbButton = thumbButtonManager.CreateThumbButton(1,\n Icons.Navigation_First_2, \"To reduce the progress\");\n\n decreaseThumbButton.Clicked += delegate\n {\n // ..\n };\n\n thumbButtonManager.AddThumbButtons(decreaseThumbButton);\n}Теперь, при запуске приложения можно увидеть что появилась одна кнопка управления. Однако, если мы попробуем нажать на нее, то увидим, что обработчик события не срабатывает. Для того, чтобы обработчик начал работать необходимо в методе WndProc явно передать возможность объекту ThumbButtonManager обрабатывать события.
В итоге получим следующий несложный код.
\nprivate ThumbButtonManager _thumbButtonManager;\n\nprotected override void WndProc(ref Message m)\n{\n if (m.Msg == Windows7Taskbar.TaskbarButtonCreatedMessage)\n {\n InitializeThumbButtons();\n }\n\n if (_thumbButtonManager != null)\n _thumbButtonManager.DispatchMessage(ref m);\n\n base.WndProc(ref m);\n}\n\nprotected void InitializeThumbButtons()\n{\n if (_thumbButtonManager == null)\n {\n _thumbButtonManager = WindowsFormsExtensions.CreateThumbButtonManager(this);\n }\n\n var decreaseThumbButton = _thumbButtonManager.CreateThumbButton(1,\n Icons.Navigation_First_2, \"To reduce the progress\");\n\n decreaseThumbButton.Clicked += delegate\n {\n Progress.Text = (float.Parse(Progress.Text) - 10).ToString();\n WindowsFormsExtensions.SetTaskbarProgress(this, float.Parse(Progress.Text));\n };\n\n // other buttons\n\n _thumbButtonManager.AddThumbButtons(decreaseThumbButton, normalStateThumbButton,\n indeterminateStateThumbButton, pauseStateThumbButton,\n errorStateThumbButton, increaseThumbButton);\n}Это приложение содержит кнопки для управления прогрессом (как и в прошлом случае) и содержит 6 кнопок.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part2/7c7daffa/2@2x.png\")
",
"tags": [
".NET",
"Windows",
"Панель задач Windows 7"
],
"banner_image": "https://blog.zwezdin.com/2009/windows7-taskbar-part2/f4b31a4d/windows7_taskbar-part2@cover.png"
},
{
"id": "https://blog.zwezdin.com/2009/jlinq/",
"url": "https://blog.zwezdin.com/2009/jlinq/",
"title": "jLinq – LINQ for JavaScript",
"date_published": "2009-05-05T12:00:00.000Z",
"content_html": "На сегодняшний день огромное число разработчиков используют JavaScript в своих проектах. Однако, само по себе программирование на JavaScript – мероприятие не очень приятное. Благодаря этому за последнее время мы могли наблюдать как появляются одни за другими новые JavaScript Framework`и (jQuery, ExtJS, Prototype, Moo и т.д) и библиотеки.
\nСегодня я хочу рассказать об еще одной библиотеке – jLinq.
\nУникальность jLinq заключается в том, что с ее помощью мы можем делать LINQ-запросы в JavaScript коде. Выглядит запрос на jLinq следующим образом.
\nvar results = jLinq.from(data.users)\n .startsWith(\"first\", \"a\")\n .orEndsWith(\"y\")\n .orderBy(\"admin\",\"age\")\n .select();Таким образом, мы можем получить преимущества LINQ при программировании на JavaScript.
", "tags": [ "LINQ", "JavaScript" ], "banner_image": "https://blog.zwezdin.com/2009/jlinq/355a12a7/jlinq@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/windows7-taskbar-part1/", "url": "https://blog.zwezdin.com/2009/windows7-taskbar-part1/", "title": "Программируем Windows 7: Taskbar. Часть 1 - Progress Bar", "date_published": "2009-04-30T12:00:00.000Z", "content_html": "Новая операционная система Windows 7 содержит большое количество нововведений и улучшений. Эти улучшения касаются безопасности, производительности, надежности и т.д. Серьезное внимание также уделено и пользовательскому интерфейсу. Для разработчиков ПО на платформе Windows новая ОС также представляет интерес, т.к. в ней содержатся элементы, на которые можно воздействовать программно. В течении нескольких постов мы поговорим об основных нововведениях и программной модели для них.
\nПервое что бросается в глаза при работе с Windows 7 – это, конечно, обновленный task bar. В новом taskbar’е действительно много концептуальных изменений. Одно из таких изменений – возможность отображения прогресса выполнения задачи (progress bar).
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part1/0f3a2ce1/1@2x.png\")
\n\n\n\n\nНа этом рисунке хорошо видно, что прямо на панели задач отображается информация о процессе копирования. Такая функциональность реализована в Windows 7 для копирования файлов на диске, загрузке данных из сети (IE8). Однако, важно, что эту функциональность мы можем использовать и для своих приложений. Сценариев может быть огромное количество – отображение процесса преобразования, копирования, формирования данных, построение отчетов, генерация изображений, и т.д.
\nС точки зрения разработчика клиентских приложений для Windows, процесс использования данной функциональности представляется достаточно просто. Взаимодействие с ОС происходит на unmanaged уровне, поэтому для .NET приложений необходима реализация управляемых оберток. Всю эту работу уже проделали разработчики из Microsoft и поместили это в библиотеку .NET Interop Sample Library.
\nБиблиотека .NET Interop Sample Library состоит из множества компонентов и демонстрационных приложений. Мы не будем подробно останавливаться на каждом из них. Для нас важно, что в ее состав входит Vista Bridge Sample Library, Windows7.DesktopIntegration и Windows7.DesktopIntegration.Registration.
Проект Windows7.DesktopIntegration содержит те классы, которые необходимы нам для работы с taskbar’ом. В составе этого проекта есть класс WindowsFormsExtensions, который содержит набор методов расширения (extension methods) для класса Form (Windows Forms). В нашем случае нас интересуют сдледующие методы:
SetTaskbarProgress(float percent)SetTaskbarProgressState(ThumbnailProgressState state)Вызов первого метода позволяет указать процент выполнения текущей задачи. Т.к. это методы расширения для класса Form, то этот класс передается в метод в качестве параметра. Это необходимо для того, чтобы определить handle окна, для которого выполняются действия.
\n// процесс выполнения = 35%\n\n// вызов метода расширения\nWindowsFormsExtensions.SetTaskbarProgress(this, 35);\n\n// или так (this = Form)\nthis.SetTaskbarProgress(35);У нас также имеется возможность указать состояние прогресс-бара. Доступные состояния:
\nNoProgress – прогресс не отображаетсяIndeterminate – прогресс бар постоянно мерцаетNormal – обычное отображение прогрессаError – отображение ошибкиPaused – отображение паузыЗадание состояние прогресс-бара осуществляется при помощи второго метода.
\nWindowsFormsExtensions.SetTaskbarProgressState(this, Windows7Taskbar.ThumbnailProgressState.Normal);\n\n// или так\n\nthis.SetTaskbarProgressState(Windows7Taskbar.ThumbnailProgressState.Normal);К сожалению, методы расширения существуют только для WinForms приложений. Однако, несложно построить подобный класс и для WPF приложений (см. демо-приложение).
\nВ итоге я собрал небольшое приложение, которое демонстрирует возможности прогресс-бара в панели задач Windows 7. Выглядит оно следующим образом.
\n\n\n\n![\"Программируем](\"https://blog.zwezdin.com/2009/windows7-taskbar-part1/5dad68a3/2@2x.png\")
\n\n\n\n\nС помощью управляющих кнопок мы можем указать текущее значение прогресс-бара, а также можем выбрать его состояние.
\n\n\n\n![\"Режим](\"https://blog.zwezdin.com/2009/windows7-taskbar-part1/b669911b/3@2x.png\")
![\"Режим](\"https://blog.zwezdin.com/2009/windows7-taskbar-part1/a669cefa/4@2x.png\")
![\"Режим](\"https://blog.zwezdin.com/2009/windows7-taskbar-part1/fbab175a/5@2x.png\")
![\"Режим](\"https://blog.zwezdin.com/2009/windows7-taskbar-part1/0e166312/6@2x.png\")
Все мы знаем, что технологии WPF и XAML позволяют достаточно существенно изменять внешний вид приложения. Однако, как выясняется, далеко не все знают как это можно делать удобно.
\nДля определения внешнего вида элементов управления мы обычно используем ControlTemplate, а динамику задаем используя триггеры. Несомненно, триггеры в XAML – мощнейший инструмент благодаря которому у нас появляется столько дополнительных возможностей. Тем не менее при построении сложных интерфейсов логика, построенная на триггерах бывает нетривиальной и непрозрачной, а порой и вовсе задает определенные ограничения.
Альтернативным способом построения задания внешнего вида элементов управления является использование объекта VisualStateManager. Я не буду вдаваться в глубокие технические детали реализации VisualStateManager, упомяну лишь самое необходимое.
VisualStateManager – это DependencyObject, со всеми вытекающими последствиями. Мы можем задать поведение этого объекта для каждого элемента управления, которым хотим управлять. Идея VSM основана на реализации состояния элемента управления. Мы можем определить набор состояний (VisualState), в которых может находится элемент управлений и задать для каждого состояния свой вид. Состояния упаковываются в группы (VisualStateGroup). Таким образом, можно определить логические группы состояний и определить в них переходы.
Каждое состояние (VisualState) по сути представляет собой Storyboard. Реализация состояния заключается в том, что при переходе в это состояние срабатывает заданный Storyboard, т.е. запускается анимация.
Можно графически представить представление описанной структуры.
\n\n\n\n![\"VisualStateManager](\"https://blog.zwezdin.com/2009/visualstatemanager/e19b9908/1@2x.png\")
\n\n\n\n\nДавайте создадим небольшой пример на основе состояний. Создадим новый UserControl в WPF приложении с самой простой структурой.
<UserControl x:Class=\"WpfApplication15.UserControl1\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\">\n <Grid>\n <Border Name=\"State1Panel\" Background=\"Red\" Opacity=\"1\"/>\n\n <TextBlock Text=\"Text of control\" Foreground=\"White\" HorizontalAlignment=\"Center\" VerticalAlignment=\"Center\"/>\n </Grid>\n</UserControl>Как видно, это обычный элемент управления с текстом и красным фоном. Давайте определим два состояния для этого элемента управления – State1 и State2. Каждое из состояний визуально будет отличаться фоном. Для этого опишем два объекта VisualState и зададим анимации перехода. В нашем случае просто положим друг на друга два элемента Border с разным фоном. Анимация будет заключаться в скрытии и отображении нужного элемента в зависимости от состояния.
<UserControl x:Class=\"WpfApplication15.UserControl1\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\">\n <Grid>\n <VisualStateManager.VisualStateGroups>\n <VisualStateGroup x:Name=\"Common\">\n <VisualState x:Name=\"State1\">\n <Storyboard>\n <DoubleAnimation To=\"1\" Duration=\"0:00:00.4\" Storyboard.TargetName=\"State1Panel\" Storyboard.TargetProperty=\"(UIElement.Opacity)\" />\n <DoubleAnimation To=\"0\" Duration=\"0:00:00.7\" Storyboard.TargetName=\"State2Panel\" Storyboard.TargetProperty=\"(UIElement.Opacity)\" />\n </Storyboard>\n </VisualState>\n <VisualState x:Name=\"State2\">\n <Storyboard>\n <DoubleAnimation To=\"0\" Duration=\"0:00:00.7\" Storyboard.TargetName=\"State1Panel\" Storyboard.TargetProperty=\"(UIElement.Opacity)\" />\n <DoubleAnimation To=\"1\" Duration=\"0:00:00.4\" Storyboard.TargetName=\"State2Panel\" Storyboard.TargetProperty=\"(UIElement.Opacity)\" />\n </Storyboard>\n </VisualState>\n </VisualStateGroup>\n </VisualStateManager.VisualStateGroups>\n <Border Name=\"State2Panel\" Background=\"Green\" Opacity=\"0\"/>\n <Border Name=\"State1Panel\" Background=\"Red\" Opacity=\"1\"/>\n\n <TextBlock Text=\"Text of control\" Foreground=\"White\" HorizontalAlignment=\"Center\" VerticalAlignment=\"Center\"/>\n </Grid>\n</UserControl>Теперь, используя VisualStateManager, можно переключать состояния элемента управления и таким образом влиять на внешний вид. Для этого разместим элемент управления на форме.
<Window x:Class=\"WpfApplication15.Window1\"\n xmlns=\"http://schemas.microsoft.com/winfx/2006/xaml/presentation\"\n xmlns:x=\"http://schemas.microsoft.com/winfx/2006/xaml\"\n xmlns:WpfApplication15=\"clr-namespace:WpfApplication15\"\n Title=\"Window1\" Height=\"300\" Width=\"300\">\n <Grid>\n <Grid.RowDefinitions>\n <RowDefinition/>\n <RowDefinition Height=\"40\"/>\n </Grid.RowDefinitions>\n <WpfApplication15:UserControl1 x:Name=\"Control1\" Height=\"118\" VerticalAlignment=\"Top\" Margin=\"50,12,101,0\" />\n\n <StackPanel Orientation=\"Horizontal\" Grid.Row=\"1\">\n <Button Name=\"State1Button\" Width=\"75\" Click=\"State1Button_Click\">State1</Button>\n\n <Button Name=\"State2Button\" Width=\"75\" Click=\"State2Button_Click\">State2</Button>\n </StackPanel>\n </Grid>\n</Window>И создадим обработчики нажатия кнопок.
\nprivate void State1Button_Click(object sender, RoutedEventArgs e)\n{\n VisualStateManager.GoToState(Control1, \"State1\", true);\n}\n\nprivate void State2Button_Click(object sender, RoutedEventArgs e)\n{\n VisualStateManager.GoToState(Control1, \"State2\", true);\n}В итоге имеем следующее приложение.
\n\n\n\n![\"VisualStateManager](\"https://blog.zwezdin.com/2009/visualstatemanager/09b35053/2@2x.png\")
\n\n\n\n\nТаким образом мы можем создать несколько состояний нашего элемента управления и на основе него строить пользовательский интерфейс.
\nТакой подход становится особенно полезным, когда мы видим, что для стандартных элементов управления существует набор предопределенных состояний. Например, для кнопки – Normal, MouseOver, Pressed, Disabled и т.д. Такие состояния есть и у других элементов. Благодаря такой возможности существенно упрощается создание шаблонов для элементов управления. Например, кнопку мы можем описать следующим образом.
<Style TargetType=\"{x:Type Button}\">\n <Setter Property=\"Margin\" Value=\"5\"/>\n <Setter Property=\"Width\" Value=\"100\"/>\n <Setter Property=\"Template\">\n <Setter.Value>\n <ControlTemplate TargetType=\"{x:Type Button}\">\n <Grid>\n <VisualStateManager.VisualStateGroups>\n <VisualStateGroup x:Name=\"Common\">\n <VisualState x:Name=\"Normal\"/>\n <VisualState x:Name=\"MouseOver\">\n <Storyboard>\n <DoubleAnimation To=\"0\" Duration=\"0:00:00.5\" Storyboard.TargetName=\"NormalBorder\" Storyboard.TargetProperty=\"(UIElement.Opacity)\" />\n <DoubleAnimation To=\"1\" Duration=\"0:00:00.3\" Storyboard.TargetName=\"OverBorder\" Storyboard.TargetProperty=\"(UIElement.Opacity)\" />\n <DoubleAnimation From=\"0\" To=\"10\" AutoReverse=\"True\" Duration=\"0:00:00.3\" Storyboard.TargetName=\"OverBorderRotateTransform\" Storyboard.TargetProperty=\"Angle\" />\n </Storyboard>\n </VisualState>\n <VisualState x:Name=\"Pressed\">\n <Storyboard>\n <DoubleAnimation To=\"0\" Duration=\"0:00:00.5\" Storyboard.TargetName=\"NormalBorder\" Storyboard.TargetProperty=\"(UIElement.Opacity)\" />\n <DoubleAnimation To=\"1\" Duration=\"0:00:00.3\" Storyboard.TargetName=\"OverBorder\" Storyboard.TargetProperty=\"(UIElement.Opacity)\" />\n <DoubleAnimation From=\"0\" To=\"360\" AutoReverse=\"True\" Duration=\"0:00:00.4\" Storyboard.TargetName=\"OverBorderRotateTransform\" Storyboard.TargetProperty=\"Angle\" />\n </Storyboard>\n </VisualState>\n </VisualStateGroup>\n </VisualStateManager.VisualStateGroups>\n\n <Border Name=\"NormalBorder\" CornerRadius=\"5\" Background=\"Gray\" Opacity=\"1\"/>\n <Border Name=\"OverBorder\" CornerRadius=\"5\" Background=\"Green\" Opacity=\"0\">\n <Border.RenderTransform>\n <RotateTransform x:Name=\"OverBorderRotateTransform\" CenterX=\"50\" CenterY=\"20\" />\n </Border.RenderTransform>\n </Border>\n\n <ContentPresenter Content=\"{TemplateBinding Content}\" Margin=\"5\" HorizontalAlignment=\"Center\" VerticalAlignment=\"Center\"/>\n </Grid>\n </ControlTemplate>\n </Setter.Value>\n </Setter>\n</Style>Теперь наши кнопки будут выглядеть следующим образом.
\n\n\n\n![\"VisualStateManager](\"https://blog.zwezdin.com/2009/visualstatemanager/7da5a97b/3@2x.png\")
\n\n\n\n\nАналогичным образом можно настраивать внешний вид в приложениях на Silverlight.
", "tags": [ "WPF", "XAML", "Silverlight" ], "banner_image": "https://blog.zwezdin.com/2009/visualstatemanager/ed5c0f70/visualstatemanager@cover.png" }, { "id": "https://blog.zwezdin.com/2009/silverlight-3d/", "url": "https://blog.zwezdin.com/2009/silverlight-3d/", "title": "3D-возможности в Silverlight 3", "date_published": "2009-04-13T12:00:00.000Z", "content_html": "Как известно, в WPF присутствуют замечательные возможности по работе с 3D. Silverlight в этом отношении существенно уступает WPF, т.к. является кросс-платформенной технологией. Так было до второй версии Silverlight. Однако, в третьей версии поддержка 3D появилась. Эту тему мы как раз и рассмотрим.
\nНа самом деле, если взглянуть чуть детальнее на возможности 3D в Siliverlight 3, то можно быстро понять что это не та поддержка, которая присутствует в WPF. Это, собственно, и логично. По своей сути, возможности 3D в Silverlight сводятся к получению проекций изображения под разными углами по трём осям. Конечно, это не то, чего хотелось бы в идеале, тем не менее эта функциональность позволяет представить наше приложение в трехмерном виде.
\nЗа получение 3D-проекций в Silverlight 3 отвечает свойство Projection, которое доступно для всех объектов. Используя это свойство можно задать параметры отображения элемента. Давайте создадим обычную панель, в которую положим стандартные элементы управления.
<StackPanel Name=\"InputPanel\" Grid.Row=\"1\">\n <TextBlock Text=\"Text:\"/>\n <TextBox />\n <ComboBox />\n <Button Content=\"Go!\"/>\n</StackPanel>Теперь получим 3D-проекцию нашей панели. Повернем панель по оси X.
\n<StackPanel Name=\"InputPanel\" Grid.Row=\"1\">\n <StackPanel.Projection>\n <PlaneProjection RotationX=\"20\" />\n </StackPanel.Projection>\n <TextBlock Text=\"Text:\"/>\n <TextBox />\n <ComboBox />\n <Button Content=\"Go!\"/>\n</StackPanel>Что интересно, значения параметров 3D-проекций можно изменять при помощи привязок и в рамках различных действий анимации (что логично). Это делает проекции Silverlight вполне пригодным для использования механизмом.
\nДавайте протестируем это. Создадим три элемента управления Slider. Привяжем каждый такой элемент управления к своей оси.
<StackPanel>\n <Slider Value=\"{Binding ElementName=InputPanel, Path=Projection.RotationX, Mode=TwoWay}\" Minimum=\"0\" Maximum=\"720\" />\n <Slider Value=\"{Binding ElementName=InputPanel, Path=Projection.RotationY, Mode=TwoWay}\" Minimum=\"0\" Maximum=\"720\" />\n <Slider Value=\"{Binding ElementName=InputPanel, Path=Projection.RotationZ, Mode=TwoWay}\" Minimum=\"0\" Maximum=\"720\" />\n</StackPanel>\n\n<StackPanel Name=\"InputPanel\" Grid.Row=\"1\">\n <StackPanel.Projection>\n <PlaneProjection RotationX=\"20\" />\n </StackPanel.Projection>\n <TextBlock Text=\"Text:\"/>\n <TextBox />\n <ComboBox />\n <Button Content=\"Go!\"/>\n</StackPanel>Теперь мы можем вращать изображение в 3D-пространстве в режиме реального времени! :))) Вот как выглядит приложение.
\n\n\n\n![\"3D-возможности](\"https://blog.zwezdin.com/2009/silverlight-3d/2d1cc647/1@2x.png\")
",
"tags": [
"XAML",
"Silverlight"
],
"banner_image": "https://blog.zwezdin.com/2009/silverlight-3d/655d5693/silverlight_3d@cover.png"
},
{
"id": "https://blog.zwezdin.com/2009/silverlight-hyperlink/",
"url": "https://blog.zwezdin.com/2009/silverlight-hyperlink/",
"title": "Использование гиперссылок внутри текста в Silverlight 3",
"date_published": "2009-04-10T12:00:00.000Z",
"content_html": "Вставить гиперссылку внутри какого-то текста – совершенно обычная задача для web-приложений. Очень часто мы делаем это при создании HTML документов. К сожалению, элементы управления в Silverlight не позволяют вставлять гиперссылки внутри текста. Давайте рассмотрим пример того, как можно обойти это ограничение.
\nЕсли быть до конца честным, то в Silverlight 3 есть элемент управления HyperlinkButton, который все-таки позволяет вставлять гиперссылки в приложения Silverlight. Проблема этого контрола заключается в том, что по умолчанию невозможно вставить его внутри текста. Одним из решением данной проблемы может быть построение нового элемента управления следующим образом.
Во-первых, разобьем наше предложение на слова. Разделителем может быть, например, пробел и знаки препинания. После этого необходимо будет понять какие из слов являются гиперссылками. Для этих целей можно использовать, например, регулярные выражения.
\nВо-вторых, для каждого слова создадим собственный элемент управления. Если слово не является гиперссылкой, то создадим для него элемент управления TextBlock. Если слово является гиперссылкой, то создадим для него элемент управления HyperlinkButton.
В третьих, разместим все наши элементы управления в контейнере WrapPanel.
Собственный элемент управления можно реализовать несколькими способами. В качестве базы можно использовать UserControl или какие-то другие типы контролов. Однако, удобнее в качестве базового объекта выбрать WrapPanel, т.к. никакой дополнительной логики в нашем случае не требуется.
Давайте рассмотрим процесс построения такого элемента управления по шагам.
\nШаг 1: Создадим элемент управления и унаследуем его от WrapPanel.
public class LinkTextBlock : WrapPanel\n{\n //...\n}Шаг 2: Создадим свойство, которое содержит текст.
\npublic class LinkTextBlock : WrapPanel\n{\n public static DependencyProperty TextProperty;\n\n static LinkTextBlock()\n {\n TextProperty = DependencyProperty.Register(\"Text\", typeof(string), typeof(LinkTextBlock), new PropertyMetadata(String.Empty, TextChangedCallback));\n // ...\n }\n\n private static void TextChangedCallback(DependencyObject d, DependencyPropertyChangedEventArgs e)\n {\n var control = (LinkTextBlock)d;\n control.BuildControls();\n }\n\n public string Text\n {\n get { return (string)GetValue(TextProperty); }\n set { SetValue(TextProperty, value); }\n }\n\n // ...\n}Шаг 3: Определим метод для разбивки предложения на слова. Будем запускать этот метод всякий раз когда обновляется текст (метод TextChangedCallback).
private void BuildControls()\n{\n Children.Clear();\n\n foreach (UIElement control in from word in Text.Split(' ')\n select BuildWordControl(word))\n {\n Children.Add(control);\n }\n}Шаг 4: Определяем метод для построения элементов управления для каждого слова.
\nprivate UIElement BuildWordControl(string text)\n{\n UIElement result;\n string url, displayText;\n\n if ((CheckLinkMethod != null) && (CheckLinkMethod(text, out url, out displayText) == true))\n {\n Uri navigateUri = new Uri(..);\n\n result = new HyperlinkButton() { Content = displayText, Tag = url, NavigateUri = navigateUri };\n ((HyperlinkButton)result).Click += delegate(object sender, RoutedEventArgs e)\n {\n // do something\n };\n }\n else\n {\n result = new TextBlock() { Text = text };\n }\n\n return result;\n}На этом элемент управления готов к употреблению :)
\n\n\n\n![\"Использование](\"https://blog.zwezdin.com/2009/silverlight-hyperlink/2c92ad77/1@2x.png\")
\n\n\n\n\nВ финальном коде я вставил делегаты, которые позволяют задавать логику определения гиперссылок, стили для слов, подсказки и другие вспомогательные элементы. Скачать исходный код проекта можно по ссылке ниже.
", "tags": [ "XAML", "Silverlight" ], "banner_image": "https://blog.zwezdin.com/2009/silverlight-hyperlink/b43402e4/silverlight_hyperlink@cover.png" }, { "id": "https://blog.zwezdin.com/2009/tooltip-silverlight-3-part2/", "url": "https://blog.zwezdin.com/2009/tooltip-silverlight-3-part2/", "title": "Tooltip в Silverlight 3 – часть 2", "date_published": "2009-04-07T12:00:00.000Z", "content_html": "Совсем недавно мы поговорили о том, каким образом можно переопределить внешний вид всплывающей подсказки в Silverlight приложениях. После этого подсказка стала выглядеть более интересно. Однако, эффект появления так и остается унылым :) Давайте попробуем изменить способ появления этой подсказки путем добавления анимации.
\nОднако, хочу сразу оговориться о том, что задание анимации требует использования триггеров, а их, к сожалению, нельзя задать из стилей. По этой причине на этот раз откажемся от использования стилей.
\nИтак, самое простое что мы можем анимировать – это свойство Opacity. Давайте сделаем это.
<Button Content=\"Click me!\" Width=\"100\" Height=\"100\">\n <ToolTipService.ToolTip>\n <ToolTip Name=\"RootLayout\" Width=\"100\" Height=\"100\" >\n <ToolTip.Triggers>\n <EventTrigger>\n <BeginStoryboard>\n <Storyboard>\n <DoubleAnimation Storyboard.TargetName=\"RootLayout\"\n Storyboard.TargetProperty=\"Opacity\"\n From=\"0\"\n To=\"1\"\n Duration=\"0:0:00.2\"/>\n </Storyboard>\n </BeginStoryboard>\n </EventTrigger>\n </ToolTip.Triggers>\n <TextBlock Text=\"123\"/>\n </ToolTip>\n </ToolTipService.ToolTip>\n</Button>Из приведенного кода видно, что в процессе анимации изменяется прозрачность главного элемента. Однако подобная анимация мало чем отличается от стандартного поведения. Давайте добавим больше динамичности. Реализуем появление подсказки в виде маятника.
\nДля этих целей нам потребуется добавить две трансформации – ScaleTransofrm и RenderTransform. После этого можно изменять параметры этих трансформаций и моделировать поведение маятника.
<DoubleAnimation Storyboard.TargetName=\"ScaleMe\" Storyboard.TargetProperty=\"ScaleX\" From=\"0\" To=\"1\" Duration=\"0:0:00.1\"/>\n<DoubleAnimation Storyboard.TargetName=\"ScaleMe\" Storyboard.TargetProperty=\"ScaleY\" From=\"0\" To=\"1\" Duration=\"0:0:00.1\"/>\n<DoubleAnimationUsingKeyFrames Storyboard.TargetName=\"RotateMe\" Storyboard.TargetProperty=\"Angle\">\n <DoubleAnimationUsingKeyFrames.KeyFrames>\n <DoubleKeyFrameCollection>\n <LinearDoubleKeyFrame KeyTime=\"0:00:00.1\" Value=\"-15\" />\n <LinearDoubleKeyFrame KeyTime=\"0:00:00.2\" Value=\"15\" />\n <LinearDoubleKeyFrame KeyTime=\"0:00:00.3\" Value=\"-11\" />\n <LinearDoubleKeyFrame KeyTime=\"0:00:00.4\" Value=\"11\" />\n <LinearDoubleKeyFrame KeyTime=\"0:00:00.5\" Value=\"-3\" />\n <LinearDoubleKeyFrame KeyTime=\"0:00:00.6\" Value=\"3\" />\n <LinearDoubleKeyFrame KeyTime=\"0:00:00.7\" Value=\"0\" />\n </DoubleKeyFrameCollection>\n </DoubleAnimationUsingKeyFrames.KeyFrames>\n</DoubleAnimationUsingKeyFrames>Достаточно часто в наших приложениях нам требуется создавать всплывающие подсказки. В Silverlight для этого существует класс ToolTip.
С помощью этого класса мы можем достаточно легко создавать такие подсказки:
\n<Button Content=\"Click me!\" Width=\"100\" Height=\"100\">\n <ToolTipService.ToolTip>\n <ToolTip Width=\"100\" Height=\"100\">\n <TextBlock Text=\"123\"/>\n </ToolTip>\n </ToolTipService.ToolTip>\n</Button>Как видно, код достаточно прост и лаконичен. Однако, подсказки, которые мы видим при этом могут показаться скучными.
\n\n\n\n![\"Tooltip](\"https://blog.zwezdin.com/2009/tooltip-silverlight-3-part1/c747ef5a/1@2x.png\")
\n\n\n\n\nДавайте посмотрим на то, каким образом можно определить поведение этих подсказок в более интересном виде. Также как и в WPF мы можем переопределить общий шаблон для объекта ToolTip и существенно изменить его внешний вид.
<Button Content=\"Click me!\" Width=\"100\" Height=\"100\">\n <ToolTipService.ToolTip>\n <ToolTip Width=\"100\" Height=\"100\">\n <ToolTip.Template>\n <ControlTemplate TargetType=\"ToolTip\">\n <Border CornerRadius=\"5\" Background=\"Red\">\n <ContentPresenter Margin=\"5\" Content=\"{TemplateBinding Content}\"/>\n </Border>\n </ControlTemplate>\n </ToolTip.Template>\n\n <TextBlock Text=\"123\"/>\n </ToolTip>\n </ToolTipService.ToolTip>\n</Button>Теперь наша подсказка стала более привлекательной.
\n\n\n\n![\"Tooltip](\"https://blog.zwezdin.com/2009/tooltip-silverlight-3-part1/fe5c9e58/2@2x.png\")
\n\n\n\n\nПонятно, что определять ControlTemplate каждый раз для каждой подсказки дело неблагодарное, поэтому определим подсказки стиль.
<Button Content=\"Click me!\" Width=\"100\" Height=\"100\">\n <ToolTipService.ToolTip>\n <ToolTip Width=\"100\" Height=\"100\">\n <ToolTip.Style>\n <Style TargetType=\"ToolTip\">\n <Setter Property=\"Template\">\n <Setter.Value>\n <ControlTemplate TargetType=\"ToolTip\">\n <Border CornerRadius=\"5\" Background=\"Red\">\n <ContentPresenter Margin=\"5\" Content=\"{TemplateBinding Content}\"/>\n </Border>\n </ControlTemplate>\n </Setter.Value>\n </Setter>\n </Style>\n </ToolTip.Style>\n\n <TextBlock Text=\"123\"/>\n </ToolTip>\n </ToolTipService.ToolTip>\n</Button>После этого можно вынести этот стиль в ресурсы и использовать его многократно.
\n<UserControl.Resources>\n <Style x:Key=\"TooltipStyle\" TargetType=\"ToolTip\">\n <Setter Property=\"Template\">\n <Setter.Value>\n <ControlTemplate TargetType=\"ToolTip\">\n <Border CornerRadius=\"5\" Background=\"Red\">\n <ContentPresenter Margin=\"5\" Content=\"{TemplateBinding Content}\"/>\n </Border>\n </ControlTemplate>\n </Setter.Value>\n </Setter>\n </Style>\n</UserControl.Resources>\n\n<!-- .... --->\n\n<Button Content=\"Click me!\" Width=\"100\" Height=\"100\">\n <ToolTipService.ToolTip>\n <ToolTip Width=\"100\" Height=\"100\" >\n <TextBlock Text=\"123\"/>\n </ToolTip>\n </ToolTipService.ToolTip>\n</Button>Теперь наша подсказка стала более приятной визуально.
\nОднако, справедливости ради, нужно сказать, что вынесение в стили не всегда возможно, но об этом мы поговорим в следующий раз.
", "tags": [ "XAML", "Silverlight" ], "banner_image": "https://blog.zwezdin.com/2009/tooltip-silverlight-3-part1/a3c690a2/tooltip_silverlight-3-part1@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/adonet-data-services-sqlcompact/", "url": "https://blog.zwezdin.com/2009/adonet-data-services-sqlcompact/", "title": "Использование ADO.NET Data Services и SQL Compact", "date_published": "2009-03-30T12:00:00.000Z", "content_html": "На этот раз мы с вами посмотрим каким образом можно работать с данными из SQL Compact поверх ADO.NET Data Services.
\nВажное замечание. На самом деле, SQL Compact не совсем правильно использовать совместно с ADO.NET Data Services. Дело в том, что SQL Compact изначально не ориентирован на режим многопользовательской работы и предназначен для других целей – для использования в качестве локального хранилища. Использование SQL Compact в качестве хранилища данных в данном случае может отрицательно сказаться на производительности вашего веб-сервиса.
\nТем не менее, не исключено, что в вашем случае необходим будет именно SQL Compact. Именно для этого случая давайте посмотрим как же все-таки можно построить веб-сервис на основе SQL Compact в качестве хранилища данных. Для того, чтобы это сделать нужно выполнить несколько простых шагов:
\nSQLMetal, добавляем явное указание первичных ключей и, если это необходимо, добавляем реализацию IUpdatable;CreateDataSource() у веб-сервиса, в котором явно создадим новую модель данных, в конструкторе которой передадим строку подключения;Application_Start) необходимо соответствующим образом сконфигурировать среду исполнения.AppDomain.CurrentDomain.SetData(\"SQLServerCompactEditionUnderWebHosting\", true);Удобнее всего это сделать в файле Global.asax, в котором как раз можем создать обработчик данного события.
public class Global : System.Web.HttpApplication\n{\n protected void Application_Start(object sender, EventArgs e)\n {\n AppDomain.CurrentDomain.SetData(\"SQLServerCompactEditionUnderWebHosting\", true);\n }\n\n //...Теперь наш сервис может работать поверх данных на базе SQL Compact и даже изменять эти данные.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2009/adonet-data-services-sqlcompact/6e7b4db7/adonet_data-services-sqlcompact@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/adonet-data-services-update/", "url": "https://blog.zwezdin.com/2009/adonet-data-services-update/", "title": "Обновление данных в рамках сервиса ADO.NET Data Services на основе LINQ to SQL", "date_published": "2009-03-27T13:00:00.000Z", "content_html": "Мы с вами продолжаем исследовать возможности использования LINQ to SQL в качестве исходной модели данных для ADO.NET Data Services. Сегодня мы поговорим о возможности изменения данных.
\nПлатформа ADO.NET Data Services предоставляет нам возможность не только выбирать данные через веб-сервис, но и обновлять их используя методы POST/PUT/MERGE/DELETE. В рамках самой модели данных необходимо реализовать интерфейс IQueryable (для каждой коллекции) для выборки данных, и IUpdatable (для всего класса-контекста) для обновления.
Вернемся к LINQ to SQL. Если мы попробуем создать модель данных LINQ to SQL, предоставить к ней доступ через ADO.NET Data Services и попробовать обновить данные, то мы с досадой обнаружим, что веб-сервис генерирует ошибку. При неглубоком изучении причины ошибки можно легко догадаться, что проблема заключается в том, что модель LINQ to SQL к сожалению не реализует IUpdateable. Здесь можно долго ругаться на разработчиков, но причины такого исхода очевидны: интерфейс IUpdatable – это составная часть ADO.NET Data Services. LINQ to SQL вышел намного раньше, чем ADO.NET Data Services. Отсюда можно сделать вывод, что реализовать еще не готовый интерфейс команда LINQ to SQL не могла.
Тем не менее, ограничение действительно серьезное и может существенно повлиять на конечное решение. Можно, конечно, отказаться от использования LINQ to SQL, но ведь это не наш метод :) Как справится с этой проблемой? Очень просто – реализовать IUpdatable вручную :)
Однако, взглянув на интерфес IUpdatable можно прийти в уныние, ведь там необходимо реализовать 12 методов с непрозрачной, на первый взгляд, логикой.
partial class NewsDataContext : IUpdatable\n{\n public void AddReferenceToCollection(object targetResource, string propertyName, object resourceToBeAdded)\n {\n throw new System.NotImplementedException();\n }\n\n public void ClearChanges()\n {\n throw new System.NotImplementedException();\n }\n\n public object CreateResource(string containerName, string fullTypeName)\n {\n throw new System.NotImplementedException();\n }\n\n public void DeleteResource(object targetResource)\n {\n throw new System.NotImplementedException();\n }\n\n public object GetResource(System.Linq.IQueryable query, string fullTypeName)\n {\n throw new System.NotImplementedException();\n }\n\n public object GetValue(object targetResource, string propertyName)\n {\n throw new System.NotImplementedException();\n }\n\n public void RemoveReferenceFromCollection(object targetResource, string propertyName, object resourceToBeRemoved)\n {\n throw new System.NotImplementedException();\n }\n\n public object ResetResource(object resource)\n {\n throw new System.NotImplementedException();\n }\n\n public object ResolveResource(object resource)\n {\n throw new System.NotImplementedException();\n }\n\n public void SaveChanges()\n {\n throw new System.NotImplementedException();\n }\n\n public void SetReference(object targetResource, string propertyName, object propertyValue)\n {\n throw new System.NotImplementedException();\n }\n\n public void SetValue(object targetResource, string propertyName, object propertyValue)\n {\n throw new System.NotImplementedException();\n }\n}Я не буду вдаваться в смысл и детали реализации каждого метода. При первом же рассмотрении эти методы кажутся вполне логичными и понятными. Для того же, чтобы вы могли уже сейчас использовать возможность обновления данных через веб-сервис на базе модели данных LINQ to SQL предлагаю вам один из вариантов реализации данного интерфейса. Скачать его себе (и использовать в своих проектах) вы можете по ссылке ниже.
\nКак вы видите интерфейс реализуется в partial-классе. Это существенно, т.к. если вы его реализуете внутри автогенерируемого файла *.designer.cs, то вы подвержены потерять этот код при любом изменении данных.
При работе с сервисами ADO.NET Data Services мы ссылаемся на модель данных используя generic-параметр. При этом экземпляр класса, реализующего модель данных создает уже инфраструктура ADO.NET Data Services, используя при этом конструктор без параметров.
\nЗачастую такого поведения вполне достаточно – создаем модель данных, в конфигурационном файле прописываем строку соединения и все работает. Тем не менее, можно встретить сценарии, когда необходимо вмешаться в этот процесс.
\nПричины могут быть самыми разнообразными:
\nDataContext, а его наследника (в котором каким-то образом изменено стандартное поведение);DataContext не имеет конструктора без параметров (да-да, и такое тоже бывает:));Во всех этих и других сценариях платформа ADO.NET Data Services предлагает нам достаточно красивый способ решения проблемы. Все, что необходимо сделать – это переопределить метод CreateDataSource() базового класса.
public class WebDataService1 : DataService<DataClasses1DataContext>\n{\n public static void InitializeService(IDataServiceConfiguration config)\n {\n config.SetEntitySetAccessRule(\"*\", EntitySetRights.AllRead);\n }\n\n protected override DataClasses1DataContext CreateDataSource()\n {\n return base.CreateDataSource();\n }\n}Как видно, этот метод как раз возвращает источник данных того типа, который указан в generic-параметре при определении базового класса. Логично, что этот метод вызывается всякий раз когда необходимо получить доступ к модели данных. Теперь мы можем задать в этом методе ту логику, которая нам необходима. Например, переопределить строку соединения:
\npublic class WebDataService1 : DataService<DataClasses1DataContext>\n{\n public static void InitializeService(IDataServiceConfiguration config)\n {\n config.SetEntitySetAccessRule(\"*\", EntitySetRights.AllRead);\n }\n\n protected override DataClasses1DataContext CreateDataSource()\n {\n return new DataClasses1DataContext(\"some connection string\");\n }\n}Как правило работа сервисов ADO.NET Data Services представляется при использовании модели данных на основе ADO.NET Entity Framework. Однако, работа с реальными проектами (и заказчиками:)) порой диктует нам другие условия. Зачастую нет никакой необходимости использовать Entity Framework. И в этом случае мы задаемся вполне резонной задачей – использовать в качестве модели данных LINQ to SQL.
\nВ ранних версиях ADO.NET Data Services все было просто — создаем модель данных, создаем сервис и все работает. С выходом релиза ADO.NET Data Services ситуация немного изменилась — при построении подобного сервиса на основе LINQ to SQL и обращении к этому сервису мы видим сообщение об ошибке.
\nКорни этой проблемы кроются в стратегии задания полей, содержащих первичные ключи. В ранних версиях при отсутствии явного указания этих полей инфраструктура ADO.NET Data Services сама пыталась определить их. Однако, в релизе эту стратегию поменяли и сейчас необходимо делать это явно.
\nПодобные поля задаются простым и естественным образом – путем навешивания атрибута DataServiceKey на сущность, в конструкторе которого как раз и указываются поля, являющиеся ключевыми. Информация о ключевых полях очень важна для сервиса, т.к. как вы помните при обращении к каждой конкретной сущности мы как раз указываем значение этого поля.
В чем же, собственно, проблема в LINQ to SQL? Проблема простая – LINQ to SQL при генерации сущности не помечает сущности этими атрибутами. Конечно же, это может вызвать негодование у разработчика, тем не менее этот досадный недостаток очень легко поправить. Вспомним, что все сущности в модели данных LINQ to SQL – это partial-классы. Сгенерируем partial-класс для каждой сущности модели данных и пометим атрибутом DataServiceKey эту сущность.
[DataServiceKey(\"NewsId\")]\n partial class New\n{\n\n}И вот, теперь наш сервис на базе LINQ to SQL работает.
\nНа самом деле, существует некое соглашение, по которому ADO.NET Data Services пытается самостоятельно определить ключевые поля в сущности. Это соглашение заключается в следующем — если сущность не помечена атрибутом DataServiceKey, то выполняются следующие действия:
ID. Если оно существует, то оно и будет являться ключевым;ID не найдено, то ищется поле EntityTypeID, где EntityType – имя вашей сущности. Например, если ваша сущность называется Customer, то будет произведена попытка обнаружить свойство CustomerID. Если такой свойство найдено, то оно и будет ключевым.Microsoft Interoperability team объявила о выходе нового проекта, который является мостом между PHP и .NET и еще больше стирает грани технологий. Этот проект позволяет разработчикам на PHP еще более проще обращаться и использовать всю мощь сервисов .NET на основе ADO.NET Data Services.
\n\n\n\n![\"PHP](\"https://blog.zwezdin.com/2009/adonet-data-services-php-toolkit/604676ba/1@2x.png\")
\n\n\n\n\nС точки зрения разработки схема выглядит достаточно классическим образом. В процессе разработки необходимо использовать утилиту PHPDataSv
\nДавайте посмотрим каким образом будет выглядеть код на платформе PHP для выполнения запросов к ADO.NET Data Services. Прежде всего необходимо подключить файл с прокси-классами, которые сгененрированы с помощью утилиты PHPDataSv
\n<?PHP\n require_once 'NorthwindClient.php';\n define(\"SERVICE_URI\", \"http://localhost:8080/Northwind.svc\");\n?>После этого можно создавать объекты класса, реализующие логику клиента и осуществлять запросы к удаленному сервису. К сожалению, здесь мы не сможем воспользоваться синтаксисом LINQ для построения запросов к сервису. Поэтому запрос в виде URI придется написать вручную.
\n<?PHP\n $client = new NorthwindEntities(SERVICE_URI);\n $query = $client->ExecuteQuery(\"Customers?\\$filter=Country eq 'UK'\");\n?>Теперь, после успешного конструирования запроса можно обратиться за данными и вывести результат пользователю:
\n<?PHP\n foreach($query as $customer)\n {\n echo \"<p>\";\n echo $customer->CustomerID;\n echo \"<br/>\";\n echo $customer->CompanyName;\n echo \"</p>\";\n }\n?>Здесь хорошо видно, что мы обращаемся к строго типизированным объектам, а результат получаем в виде объектных коллекций. Такой способ очень похож на то, как мы работаем с сервисами ADO.NET Data Services в рамках .NET-клиента. Эти классы-сущности были также сгенерированы утилитой PHPDataSv
\nPablo Castro (program manager, ADO.NET Data Services) и Claudio Caldato (program manager, interoperability , techincal strategy team) сделали небольшой обзор этой библиотеки на Channel 9 (en), в котором они рассказывают чуть больше деталей.
\nНу и наконец очень интересно то, что проект является проектом с открытым исходным кодом и доступен на CodePlex. Кроме того, проект разрабатывается компанией Persistent Systems, но оплачивается Microsoft.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2009/adonet-data-services-php-toolkit/03397f5b/adonet_data-services-php-toolkit@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/adonet-data-services-debug/", "url": "https://blog.zwezdin.com/2009/adonet-data-services-debug/", "title": "Отладка сервисов ADO.NET Data Services", "date_published": "2009-03-19T13:00:00.000Z", "content_html": "Интерес к платформе ADO.NET Data Services растет среди разработчиков веб-сервисов. Это также подтверждается и тем, что я все чаще получаю письма с вопросами о той или иной проблеме. Как правило эти вопросы сводятся к тому, что после выполнения определенной последовательности действий сервис начинает выдавать невнятную ошибку и предлагает ознакомится с деталями в логах.
\n\n\n\n![\"Отладка](\"https://blog.zwezdin.com/2009/adonet-data-services-debug/13e7b7d8/1@2x.png\")
\n\n\n\n\nЗнакомо ли вам данное сообщение? Если вы уже испытывали ADO.NET Data Services и пытались что-то сделать, то думаю что да.
\nПричина всех недоумений заключается в том, что в действительности по умолчанию ADO.NET Data Services не пишет никаких сообщений в логи, а если вам это необходимо, то вы должны позаботится об этом сами. Что же делать если хочется понять в чем истинная ошибка?
\nДостаточно обратиться к статическому методу инициализации сервиса InitializeService, параметром которого является объект-наследник IDataServiceConfiguration. Последний имеет в своем составе свойство UseVerboseErrors. Для получения внятного описания ошибки необходимо установить это свойство в true.
public static void InitializeService(IDataServiceConfiguration config)\n{\n config.SetEntitySetAccessRule(\"*\", EntitySetRights.AllRead);\n config.UseVerboseErrors = true;\n}Теперь снова обратимся к сервису и увидим описание ошибки.
\n\n\n\n![\"Отладка](\"https://blog.zwezdin.com/2009/adonet-data-services-debug/8fb1431e/2@2x.png\")
\n\n\n\n\nЗдесь мы уже можем увидеть какие-то детали и даже Stack Trace. Часто этого бывает достаточно. Однако, в определенных ситуациях до сих пор не удается понять в чем дело. После несложных операций в рефлекторе можно понять, что вся инфраструктура построена поверх Windows Communication Foundation, а конкретно WCF REST API. Как известно, в целях безопасности WCF по умолчанию скрывает детали исключения. Тем не менее, мы можем переопределить это поведение, явно указав WCF что необходимо делать в этом случае. В нашем случае сделать это проще всего используя атрибут SerivceBehavior.
[ServiceBehavior(IncludeExceptionDetailInFaults = true)]\npublic class WebDataService1 : DataService<MvcMiniCmsEntities>\n{\n //...Теперь WCF будет включать детали исключения в ответ и можно понять что происходит в каждом конкретном случае.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2009/adonet-data-services-debug/13f55e63/adonet_data-services-debug@cover.png" }, { "id": "https://blog.zwezdin.com/2009/wpf-hardware/", "url": "https://blog.zwezdin.com/2009/wpf-hardware/", "title": "Изменение внешнего вида пользовательского интерфейса в зависимости от аппаратных возможностей в WPF", "date_published": "2009-02-24T13:00:00.000Z", "content_html": "Всякий раз когда в своих приложениях на базе WPF мне хочется применить тот или иной эффект или анимацию (которая была бы к месту) меня останавливает одно – как быть с пользователями, у которых аппаратные ресурсы поскромнее.
\nНа первый взгляд кажется, что решение не лежит на поверхности – нужно каким-то образом определять возможности аппаратного обеспечения и корректировать пользовательский интерфейс. Однако, на самом деле все очень просто.
\nДело в том, что есть такой класс RenderCapatibility, который имеет статическое свойство Tier. Это свойство может содержать три разных значения, в зависимости от того, какими аппаратными возможностями вы располагаете:
0 – аппаратное ускорение для графики отсутствует на данном устройстве;1 – частичная поддержка графического аппаратного ускорения, поддержка DirectX версии 7.0 – 9.0;2 – полная поддержка аппаратного ускорения, поддержка DirectX версии 9.0 или выше.Таким образом, основываясь на этом значении вы можете корректировать визуальную составляющую в вашем приложении. Однако, есть одно “но” :) Дело в том, что на самом деле это свойство выдает значения не 0, 1 и 2, а 0, 0x00010000 и 0x00020000. Как можно заметить, это те же цифры 0, 1 и 2, но сдвинутые логически на 16 разрядов. Для получения нужных нам значений необходимо произвести обратную операцию:
int renderingTier = (RenderCapability.Tier >> 16);Теперь давайте посмотрим на то, каким образом мы можем изменять пользовательский интерфейс в зависимости от этого значения декларативно (т.е. внутри XAML).
\nДля этого нам необходимо сделать очень простую обертку над данным значениям, с помощью которой мы получим DependencyProperty, возвращающее нужное значение.
public static class RenderCapabilityWrapper\n{\n public static readonly DependencyProperty TierProperty =\n DependencyProperty.RegisterAttached(\n \"Tier\",\n typeof(int),\n typeof(RenderCapabilityWrapper),\n new PropertyMetadata(RenderCapability.Tier >> 16));\n\n public static int GetTier(DependencyObject depObj)\n {\n return (int)TierProperty.DefaultMetadata.DefaultValue;\n }\n\n public static int Tier\n {\n get\n {\n return (int)TierProperty.DefaultMetadata.DefaultValue;\n }\n }\n}Такой класс-обертка позволит нам прямо из описания пользовательского интерфейса получить значение свойства Tier и произвести изменения в пользовательском интерфейсе. Для этого лучше всего подходят триггеры.
Давайте попробуем теперь описать стиль для кнопки.
\n<Style TargetType=\"{x:Type Button}\">\n <Style.Triggers>\n <Trigger Property=\"hardware:RenderCapabilityWrapper.Tier\" Value=\"2\">\n <!-- описание стиля для Tier = 2 -->\n </Trigger>\n <Trigger Property=\"hardware:RenderCapabilityWrapper.Tier\" Value=\"1\">\n <!-- описание стиля для Tier = 1 -->\n </Trigger>\n <Trigger Property=\"hardware:RenderCapabilityWrapper.Tier\" Value=\"0\">\n <!-- описание стиля для Tier = 0 -->\n </Trigger>\n </Style.Triggers>\n</Style>Вот так легко и просто мы можем создавать адаптивный пользовательский интерфейс для наших приложений, который изменяется в зависимости от аппаратных возможностей.
", "tags": [ "WPF" ], "banner_image": "https://blog.zwezdin.com/2009/wpf-hardware/411912d3/wpf_hardware@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/linq-recurse/", "url": "https://blog.zwezdin.com/2009/linq-recurse/", "title": "Рекурсивная выборка с помощью LINQ to Objects", "date_published": "2009-02-06T13:00:00.000Z", "content_html": "Приходилось ли вам когда-нибудь работать с рекурсивными алгоритмами? Я думаю приходилось. Для этого мы создаем рекурсивный метод, в котором описываем нужную логику и сам рекурсивный вызов. Однако, достаточно часто все что необходимо сделать – это обработать “плоский” список. Давайте рассмотрим как это сделать при помощи LINQ to Objects.
\nИтак, представим, что у нас есть определенная сущность, которая содержит список дочерних узлов аналогичного типа:
\nclass Data\n{\n public string Name { get; set; }\n public IEnumerable<Data> Childs { get; set; }\n}Мы не будем рассматривать процесс инстанциации дерева, просто предположим у нас получилась вот такая структура:
\nПредположим, что для обработки всех этих данных нам нужен всего лишь “плоский” список этих узлов:
\nЧто мы можем сделать? Можно написать стандартный рекурсивный обработчик:
\npublic IEnumerable<Data> GetAllNodes(IEnumerable<Data> data)\n{\n var result = new List<Data>();\n\n if (data != null)\n {\n foreach (var item in data)\n {\n result.Add(item);\n result.AddRange(GetAllNodes(item.Childs);\n }\n }\n\n return result;\n}Тем не менее, было бы неплохо иметь возможность с помощью LINQ to Objects обработать коллекцию рекурсивно и получить “плоский” список. Если не считать SelectMany (который здесь совсем не подходит), из стандартных возможностей LINQ нет ничего подходящего. Однако, благодаря C# 3.0 мы всегда можем расширить функциональность с помощью extension-методов. Для нашего случая напишем несложный метод расширения:
internal static class RecursiveExtension\n{\n public static IEnumerable<T> SelectRecursive<T>(this IEnumerable<T> source, Func<T, IEnumerable<T>> recursiveFunc)\n {\n if (source != null)\n {\n foreach (var mainItem in source)\n {\n yield return mainItem;\n\n IEnumerable<T> recursiveSequence = (recursiveFunc(mainItem) ?? new T[] { }).SelectRecursive(recursiveFunc);\n\n if (recursiveSequence != null)\n {\n foreach (var recursiveItem in recursiveSequence)\n {\n yield return recursiveItem;\n }\n }\n }\n }\n }\n}Все готово. Теперь, используя этот метод расширения мы можем построить запрос для получения “плоского” списка:
\nIEnumerable<Data> data = ...;\n\n// \"Плоский список\"\nvar flatList = data.SelectRecursive(c => c.Childs);\n\nforeach(var item in flatList)\n{\n Console.WriteLine(item.Name);\n}\n/* Result:\n --\n Node1\n Node2\n Node3\n Node4\n Node5\n Node6\n Node7\n Node8\n Node9\n Node11\n Node12\n Node13\n Node14\n*/\n\n// Запрос\nvar query = from d in data.SelectRecursive(c => c.Childs)\n where d.Name.Contains(\"5\")\n select d.Name;\n\nforeach(var item in query)\n{\n Console.WriteLine(item);\n}\n\n/* Result:\n --\n Node5\n*/Случается, порой, так, что из сервисов WCF необходимо обращаться к HttpContext.Current. Когда? Например тогда, когда вы пользуетесь существующими HTTP-модулями (например, безопасность), которые сконфигурированы для всего web-приложения, в т.ч. наших сервисов. В этом случае при попытке обратиться к HttpContext.Current мы получаем null. Что с этим делать?
Вообще, если речь идет конкретно об аутентификационных данных, то правильнее здесь пользоваться ServiceSecurityContext.Current – в этом случае используется система безопасности WCF и клиенты, которые используют эти механизмы аутентификации/авторизации также будут корректно обрабатываться.
В случаях, когда есть необходимость работать именно с HttpContext, этого также можно достичь. Для этого необходимо включить режим совместимости хостинг-среды WCF. Для этого необходимо сделать две вещи:
Первое: Разметить сервис атрибутом AspNetCompatibilityRequirements:
[AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Required)]\npublic class MetadataService : IMetadataВторое: В настройках указать, что необходимо использовать режим совместимости ASP.NET:
\n<system.serviceModel>\n <!-- .... -->\n <serviceHostingEnvironment aspNetCompatibilityEnabled=\"true\" />\n</system.serviceModel>Конечно же такой сервис должен работать на основе HTTP в рамках IIS. Но, собственно, в противном случае HttpContext и смысла то не имеет.
Но все-таки предпочтительнее использовать встроенные механизмы безопасности.
", "tags": [ "Windows Communication Foundation", "ASP.NET" ], "banner_image": "https://blog.zwezdin.com/2009/wcf-httpcontext/69bd4f0f/wcf_httpcontext@cover.jpg" }, { "id": "https://blog.zwezdin.com/2009/already-implemented-things/", "url": "https://blog.zwezdin.com/2009/already-implemented-things/", "title": "Наиболее популярные велосипеды", "date_published": "2009-01-09T13:00:00.000Z", "content_html": "Когда-то все мы начинали изучение платформы .NET и языка C#/VB. В эти моменты жизни достаточно часто получается изобретать велосипеды. Тем не менее, бывает полезно посмотреть на них и сейчас. Приведу наиболее популярные.
\nPath.GetFileNameWithoutExtension() – позволяет получить имя файла без расширенияPath.GetRandomFileName() – генерирует случайное имя файла или папкиPath.GetTempFileName() – создает файл во временной папке со случаным именемPath.Combine(basePath, fileName) – позволяет объединить две части пути (вместо использования basePath + @"\\" + fileName)Directory.CreateDirectory() – создает папку. Кроме того, многие программисты забывают, что этот метод выполняет проверку на наличие этой папки и оборачивают этот метод в if(Directory.Exists())Environment.GetFolderPath() – позволяет получить путь до специальной папки (например, Мои документы)Environment.NewLine – символ новой строки (вместо \\r\\n)Path.DirectorySeparatorChar – символ разделения имен папок/файлов при указании пути (вместо /)File.ReadAllBytes(), File.ReadAllLines(), File.ReadAllText() – бывает что для чтения файлов мы используем потоки (FileStream), при этом заботясь об их корректном открытии/закрытии, хотя вся операция делается в 1 строчкуFile.WriteAllBytes(), File.WriteAllLines(), File.WriteAllText() – аналогично для записи в файлString.IsNullOrEmpty() – позволяет проверить строку на пустоту (делает две проверки: == null и == "")String.Split() – позволяет разбить строку на массив строк по заданному символу (например, по запятой)String.Join() – обратная операция, позволяет объединить массив строк в одну строку"...".StartsWith(), "...".EndsWith() – позволяет определить начинается ли или кончается ли заданная строка в соответствии с шаблономWebClient – позволяет получить данные из сети используя простые методы DownloadString(), DownloadFile(), DownloadData()Dns.GetHostName() – получить имя текущего хостаDns.Resolve() – получить информацию об узле по имени хостаDns.GetHostByAddress() – получить информацию об узле по IP-адресуEnumerable.Range() – сгенерировать массив чисел заданного диапазонаIEnumrable<T>.Any(predicate) – определяет удовлетворяет ли заданному условию хотя бы один элемент из спискаIEnumrable<T>.All(predicate) – определяет удовлетворяет ли заданному условию все элементы спискаIEnumerable<T>.Select() – позволяет также выполнять какие-то действия над каждым элементом списка:var data = Enumerable.Range(0, 100);\ndata.Select(delegate(int d)\n{\n DoSomething(d);\n\n return data;\n}).ToList();BitConverter – позволяет представлять данные в виде последовательности байт и обратноSystem.Data.Common.DbConnectionStringBuilder, System.Data.SqlClient.SqlConnectionStringBuilder – позволяют генерировать строки соединенияMethodBase.GetCurrentMethod().Name – позволяет получить имя текущего исполняемого метода (удобно для записи в Log)Enum.Parse() – позволяет из строки получить значение перечисленияSystem.CodeDom – позволяет генерировать и исполнять кодSystem.Diagnostics.Stopwatch – позволяет замерять время работы участков кода (очень распространенный велосипед:))CultureInfo.GetCultures() – позволяет получить список всех культр:foreach (CultureInfo culture in CultureInfo.GetCultures(CultureTypes.AllCultures &~ CultureTypes.NeutralCultures))\n{\n RegionInfo region = new RegionInfo(culture.LCID);\n Console.WriteLine(@\"{0} - {1}\", region.EnglishName, region.DisplayName);\n}“LINQ классная штука, но т.к. там все строго типизировано я не могу строить динамические запросы, а это большой минус” – такие утверждения слышу все чаще от различных разработчиков. Правильный ответ – динамические запросы генерировать можно.
\nВообще такие вопросы вижу как в онлайн (e-mail), раз пять отвечал на этот вопрос в зоне “Спроси Эксперта” на Платформе 2009, но последней каплей стало то, что мой блог нашли по запросу “dynamic queries with LINQ”. =))))))
\nИтак, в основе всего лежит интерфейс IQueryable и Expression Trees. Что это такое? Давайте подумаем, что на самом деле представляет собой выражение LINQ – фактически оно трансформируется в цепочку вызовов Extension-методов, который в свою очередь – в вызовы статических методов. Происходит это примерно в следующей последовательности:
Шаг 1: Выражение LINQ:
\nvar q = from d in data\n where d.Length > 5\n select d;Шаг 2: Цепочка методов расширения:
\nvar q = data.Where(d => d.Length > 5).Select(d => d);Шаг 3: Вызовы статических методов:
\nvar q = Enumerable.Select(Enumerable.Where(data, d => d.Length > 5), d => d);Все хорошо когда мы работаем с in-memory коллекциями, но что делать LINQ когда необходимо работать, например, с СУБД? Фактически, нужно трансформировать запрос LINQ в запрос T-SQL (в нашем случае). Вместо T-SQL может быть все что угодно, но давайте пока остановимся именно на этом варианте. Итак, как же LINQ будет осуществлять эту трансформацию? Ответ прост – для этого необходимо иметь представление нашего запроса в виде некоторой объектной модели – Expression Tree. Эта модель описывает все моменты запроса – условия, порядок сортировки, результат выборки и т.д. Основываясь на данных этой модели уже можно строить запрос на каноническом языке, в нашем случае T-SQL.
\nПричем же здесь IQueryable? Все просто — помните IEnumerable? Этот интерфейс позволяет нам пробежаться по коллекции в однонаправленном режиме. Именно на основе IEnumerable строятся все коллекции. IQueryable – это наследник IEnumerable, который включает также модель Expression Tree.
Возвращаясь к теме, давайте поговорим о том, каким образом мы можем формировать динамические запросы. Для этого, собственно, нам необходимо как раз сформировать Expression Tree и получить из этого лямбда выражение (-ия).
\nДля формирования Expression Tree существует класс Expression, который содержит различные статические методы для формирования конструкций. Здесь проще показать на примере.
Предположим, что у нас имеется коллекция строк и нам необходимо выполнить по ней фильтрацию, причем условий будет несколько и объединяться они должны по “ИЛИ”. При этом строки для поиска будет вводить пользователь и их может быть переменное количество. Если решать ту же самую задачу, но с объединением условий по “И”, то все гораздо проще: в этом случае нам необходимо несколько раз подряд вызвать extension-метод .Where<>().
Логично, что для решения этой задачи нам нужно сформировать лямбда-выражение примерно такого вида:
\nc => c.Contains(\"a\") || c.Contains(\"b\") || c.Contains(\"c\") || итдДавайте попробуем это сделать по шагам:
\nШаг 1: Формируем параметр:
\nvar param = Expression.Parameter(typeof(string), \"c\");Шаг 2: Формируем вызов метода:
\nvar condition = Expression.Call(param, typeof (string).GetMethod(\"Contains\"), Expression.Constant(\"a\"));Шаг 3: Получаем лямбда-выражение:
\nvar l = Expression.Lambda<Func<string, bool>>(condition, param);Теперь, если мы выведем полученное лямбда-выражение на экран, то увидим следующую вещь:
\nc => c.Contains(\"a\")Отлично, теперь никто нам не мешает создать несколько таких условий, используя оператор “ИЛИ” (Expression.Or). Финальный код может выглядеть следующим образом:
var param = Expression.Parameter(typeof(string), \"c\");\n\nExpression condition = null;\nstring input;\nwhile (String.IsNullOrEmpty(input = Console.ReadLine()) == false)\n{\n if (condition == null)\n {\n condition = Expression.Call(param,\n typeof(string).GetMethod(\"Contains\"),\n Expression.Constant(input));\n }\n else\n {\n condition = Expression.Or(condition,\n Expression.Call(param,\n typeof (string).GetMethod(\"Contains\"),\n Expression.Constant(input)));\n }\n}\n\nvar l = Expression.Lambda<Func<string, bool>>(condition, param);Теперь, если мы выведем на экран получившееся выражение, то увидим, что все условия объединены через “ИЛИ”.
\nЕсли мы посмотрим на переменную l, то увидим, что там содержится не Func<string, bool>, а Expression<Func<string, bool>>. Давайте исправим это, для этого необходимо вызвать метод Compile(). После этого можно использовать лямбда-выражение в ваших запросах:
string[] data = new[] { \"qwerty\", \"asdfgh\", \"zxcvb\", \"wertyu\" };\n\nvar param = Expression.Parameter(typeof(string), \"c\");\n\nExpression condition = null;\nstring input;\nwhile (String.IsNullOrEmpty(input = Console.ReadLine()) == false)\n{\n if (condition == null)\n {\n condition = Expression.Call(param,\n typeof(string).GetMethod(\"Contains\"),\n Expression.Constant(input));\n }\n else\n {\n condition = Expression.Or(condition,\n Expression.Call(param,\n typeof (string).GetMethod(\"Contains\"),\n Expression.Constant(input)));\n }\n}\n\nvar l = Expression.Lambda<Func<string, bool>>(condition, param);\n\nConsole.WriteLine(l);\n\nvar q = data.Where(l.Compile());\n\nforeach (var s in q)\n{\n Console.WriteLine(s);\n}Сервисы ADO.NET Data Services могут представлять наши данные в различных форматах. В последнее время все чаще получаю вопросы о том как получить данные от сервиса в формате отличном от AtomPub.
ADO.NET Data Services выдает информацию в том формате, в котором попросит его об этом пользователь, основываясь на HTTP-заголовке Accept. Если значение этого заголовка в HTTP-запросе не задано, то по умолчанию используется AtomPub. Итак, какие значения заголовка Accept можно использовать.
Для проверки этой функциональности очень удобно использовать утилиту Fiddler, которая позволяет исполнять HTTP-запросы с заданными параметрами, в т.ч. HTTP-заголовками. Утилита эта бесплатная, так что можно ей спокойно пользоваться :)
\n\n\n\n![\"Представление](\"https://blog.zwezdin.com/2008/adonet-data-services-representation/402062b1/1@2x.png\")
",
"tags": [
"Windows Communication Foundation"
],
"banner_image": "https://blog.zwezdin.com/2008/adonet-data-services-representation/7c316b65/adonet_data-services-representation@cover.jpg"
},
{
"id": "https://blog.zwezdin.com/2008/tsql-for-sqlcompact/",
"url": "https://blog.zwezdin.com/2008/tsql-for-sqlcompact/",
"title": "Генерация T-SQL скрипта для создания базы данных SQL Compact",
"date_published": "2008-12-15T13:00:00.000Z",
"content_html": "Во “взрослой” версии SQL Server в Management Studio существует опция генерации T-SQL скрипта для создания базы данных. Это бывает удобно когда мы, например, хотим создать чистый дубликат существующей базы данных или для каких-то других целей. К сожалению, для SQL Compact такой опции не существует.
\nТем не менее, уже нашлись умельцы, которые создали утилиту, которая на основании данных системных представлений генерирует соответствующий T-SQL скрипт.
\nЭта утилита называется ExportSqlCE и размещена на CodePlex. Представляет она собой консольное приложение, которое на выходе генерирует нужный скрипт. Запустить ее можно так:
\nExportSQLCE.exe \"Data Source=C:\\DB\\Northwind.sdf;\" Northwind.sqlПосле этого, в выходном файле мы увидим скрипт, который можем исполнить где-то еще.
", "tags": [ "LINQ" ], "banner_image": "https://blog.zwezdin.com/2008/tsql-for-sqlcompact/d8ea585d/tsql_for-sqlcompact@cover.jpg" }, { "id": "https://blog.zwezdin.com/2008/bizspark/", "url": "https://blog.zwezdin.com/2008/bizspark/", "title": "Microsoft идет на встречу инновационным компаниям-разработчикам", "date_published": "2008-12-12T13:00:00.000Z", "content_html": "Совсем недавно компания Microsoft объявила о ряде программ, поддерживающих различные сегменты рынка. Так, например, наверняка вы видели информацию о программе DreamSpark, которая призвана помочь студентам. Для молодого бизнеса появилась другая программа, встречайте — BizSpark.
\nBizSpark — это инновационная программа, предоставляющая начинающим компаниям-разработчикам ПО в течение 3 лет набор следующих преимуществ:
\nДоступ к технологиям, в том числе:
\nПоддержка:
\nПродвижение
\nУсловия предоставления BizSpark:
\nРегистрация в программе бесплатна. По окончании членства в программе, начинающая компания должна оплатить Microsoft взнос за участие в программе в размере 100 долл. США.
Тема безопасности в распределенных приложениях является очень актуальной, особенно когда сервис работает в глобальной сети. Давайте рассмотрим вопросы безопасности в рамках технологии ADO.NET Data Services.
\nВ рамках ADO.NET Data Services механизмы безопасности можно рассматривать на нескольких уровнях.
\nВо-первых, т.к. сервисы ADO.NET Data Services работают в рамках hosting-среды ASP.NET, они очень тесно интегрируются с существующей инфраструктурой ASP.NET. Это означает, что мы можем использовать существующие механизмы аутентификации ASP.NET, Membership API, Card Space и т.д. Что интересно, мы можем использовать все существующие наработки в этой области, например собственные механизмы аутентификации, реализованные в рамках HTTP-модулей.
\nВо-вторых, существует разграничение видимости на уровне объектных коллекций. Существуют варианты полного доступа (чтения/записи), чтения и выполнения запросов, только чтения одиночных сущностей, записи одиночных сущностей и др. Для того, чтобы настроить видимость на уровне контейнеров необходимо в методе InitializeService воспользоваться объектом config. У этого объекта есть два метода – SetEntitySetAccessRule и SetServiceOperationAccessRule. Эти методы идентичны, за тем исключением, что первый задает видимость для объектных коллекций, а второй – сервисных операций.
public class NorthwindService : DataService<NorthwindEntities>\n{\n public static void InitializeService(IDataServiceConfiguration config)\n {\n config.SetEntitySetAccessRule(\"*\", EntitySetRights.All);\n config.SetServiceOperationAccessRule(\"*\", ServiceOperationRights.All);\n }\n\n // ..\n}Первым параметром передается имя контейнера или операции в виде строки. Если необходимо задать настройки для всех контейнеров/операций, то используется символ *. Тем не менее, в работающих проектах таким синтаксисом я бы пользоваться не стал. Вторым параметром этим методам передается значение enum-а, который указаывает, значение видимости. Например, если мы укажем значение None, то при работе с сервисом заданную коллекцию мы просто не увидим, как будто ее нету :)
Ну и последний, самый мощный механизм – это перехватички (interceptors). Перехватчики – это специальные методы, которые исполняются на каждую отдаваемую клиенту сущность.
Например, у меня есть коллекция, которая возвращает набор заказчиков. Я могу создать следующий перехватчик:
\n[QueryInterceptor(\"Customers\")]\npublic Func<Customers, bool> OnQueryCustomers()\n{\n return c => c.ContactName.Contains(\" \") == false;\n}Как видно, этот метод возвращает лямбда-выражение, которое исполняется при отдаче клиенту каждой сущности. Это лямбда-выражение возвращет булевское значение, если оно равно true, то данная сущность отдаете клиенту, если false, то клиент ничего об этой сущности не узнает :) В данном примере мы выдаем только те сущности Customer, которые не содержат пробелов. Можно переделать этот пример следующим образом:
[QueryInterceptor(\"Customers\")]\npublic Func<Customers, bool> OnQueryCustomers()\n{\n return c => c.ContactName == HttpContext.Current.User.Identity.Name;\n}В этом случае мы используем HttpContext и получаем имя текущего пользователя. Затем если имя текущего пользователя и поле ContactName совпадают, то эту сущность мы клиенту отдаем. Таким образом, каждый пользователь будет работать со своим набором данных, несмотря на то, что данные для всех пользователей хранятся в одной таблице.
Перехватичик существуют не только для операций выборки, но и для операций модификации. В этом случае перехватчик представляет собой метод, который генерирует исключение, в случае, если операция недопустима.
\n[ChangeInterceptor(\"Customers\")]\npublic void OnChangeCategories(Customers c, UpdateOperations mode)\n{\n if ((mode == UpdateOperations.Add) || (mode == UpdateOperations.Change))\n {\n if (c.ContactTitle.Contains(\" \") == true)\n {\n throw new DataServiceException(400, \"Contact title consist of a single word.\")\n }\n }\n}Видно, что в перехватчик принимает два параметра – изменяемую сущность и тип операции. В случае ошибки генерируется исключение DataServiceException.
Точно также можно использовать инфраструктуру безопасности при модификации данных.
\n[ChangeInterceptor(\"Customers\")]\npublic void OnChangeCategories(Customers c, UpdateOperations mode)\n{\n if (mode == UpdateOperations.Delete)\n {\n if (c.ContactName == HttpContext.Current.User.Identity.Name)\n {\n throw new DataServiceException(400, \"You can't delete it.\")\n }\n }\n}Важная особенность перехватчиков, что эти методы помечаются атрибутами QueryInterceptor или ChangeInterceptor, в параметрах которых мы указываем для какой сущности предназначены эти перехватчики.
ADO.NET Data Services позвоялет строить REST-сервисы поверх какой-то готовой модели данных. Очень часто мы видим примеры сервисов ADO.NET Data Services на основе Entity Data Model или модели LINQ to SQL. Однако, это не единственные сценарии. Давайте посмотрим как это работает в действительности.
\nКак мы помним, при создании сервиса, создается класс-наследник от базового generic-класса DataContext<>. В generic-параметре мы как раз указываем класс, реализующий модель данных.
На самом деле, при обращении к сервису создается новый экзмепляр этого класса и производится поиск полей и свойств, которые имеют тип IQueryable. Если ADO.NET Data Services находит в этом классе свойства таких типов, то они предоставляеются через сервис для работы с ними. Теперь независимо от того, что на самом деле из себя представляет модель данных мы можем строить запросы к этому сервису, используя стандартный синтаксис URI.
Что это нам дает? Благодаря этому мы можем строить свои модели данных, которые используют информацию из реляционного источника, файловой системы, другого веб-сервиса, каких-то текстовых, XML файлов, и т.д. Например, мы можем построить модель данных следующим образом:
\npublic class MyDataModel\n{\n public IQueryable<string> Data1\n {\n get\n {\n string[] data = GetData();\n return data.AsQueryable();\n }\n }\n}В этом примере мы возвращаем коллекцию строк, однако мы можем построить более сложную модель данных, которая будет работать с какими-то сущностями. Для этого нам нужно создать класс, содеращий нужные нам поля и пометить этот класс атрибутом DataServiceKey, в параметрах которого указать ключевое поле:
[DataServiceKey(\"ID\")]\npublic class Person\n{\n public int ID { get; set; }\n public string Name { get; set; }\n public string Address { get; set; }\n}После этого можно предоставить коллекцию этих объектов через сервис.
\npublic class MyDataModel\n{\n public IQueryable<Person> Persons\n {\n return ...;\n }\n}Атрибут DataServiceKey является обязательным, иначе ADO.NET Data Services не сможет понять что является ключевым полем.
Таким образом, для того, чтобы создать собственную модель данных мы должны создать совершенно обычный класс, который содержит свойства, возвращающие интерфейс IQueryable. Однако, таким образом мы реализовали read-only модель данных. Для того, чтобы эту модель данных можно было обновлять, необходимо реализовать интерфейс IUpdatable уже у самого класса модели данных. Но об этом в следующий раз :)
Как мы знаем ADO.NET Data Services предоставляет нам удобный синтаксис URI, с помощью которого можно адресовать любые части модели данных. Кроме того, конструируя URI мы можем выполнять какие-то серверные операции вроде сортировки, фильтрации или разбиения на страницы. Но как же быть со сложными запросами, которые, например, включают в себя несколько join-ов?
\nПри решении этой задачи можно конечно сделать несколько обращений к сервису, получить нужные данные, а затем построить свой сложный запрос поверх in-memory объектов, но есть способ лучше :).
\nВ рамках сервисов ADO.NET Data Services мы можем создать специальные методы, которые называются сервисные операции.
\n[WebGet]\npublic IQueryable<Customers> GetCustomersWithOrders()\n{\n return ...;\n}Как мы видим у этого метода есть две особенности: во-первых, мы помечаем его атрибутом WebGet или WebInvoke; а во-вторых, для того, чтобы это была полноценная коллекция данных мы должны вернуть интерфейс IQueryable.
Теперь, когда в рамках сервиса имеется такой метод мы можем совершенно стандартно обратиться к нему следующим образом:
\nhttp://../Service.svc/GetCustomersWithOrders/Точно также мы можем создать операцию с параметрами.
\n[WebGet]\npublic IQueryable<Customers> GetCustomersWithOrders(int count)\n{\n return ...;\n}В этом случае можно обратиться к этой операции так:
\nhttp://../Service.svc/GetCustomersWithOrders/?$count=25Понятно, что в рамках этой операции мы можем строить сколько угодно сложный запрос, включая join-ы и т.д. При этом, используя свойство CurrentDataSource мы можем обратиться к источнику данных, на основе которого построен сам сервис. Таким образом, метод может выглядеть следующим образом:
[WebGet]\npublic IQueryable<Customers> GetCustomersWithOrders(int count)\n{\n var q = from c in this.CurrentDataSource.Customers\n where c.Orders.Count > count\n select c;\n\n return q.AsQueryable();\n}В данном случае мы создаем LINQ запрос к источнику данных, используя возможно какие-то параметры, join-ы, группировки, фильтровки и др. и возвращаем результат в виде IQueryable.
В этих случаях мы можем осуществлять GET-запросы к указанным операциям. Если мы хотим использовать методы, например, PUT, POST или любые другие, то мы должны использовать атрибут WebInvoke, вместо WebGet.
[SingleResult]\n[WebInvoke(Method=\"POST\")]\npublic void DoSomething()\n{\n // ...\n}При этом мы можем указать абсолютно разнообразные методы при указании параметров атрибута.
\nНу и на самом деле мы можем вовзращять не обязательно коллекцию объектов, можно вернуть например строку. При этом мы должны пометить операцию атрибутом SingleResult. Если необходимо, чтобы сервис корретно выдавал HTTP-заголовок ContentType, то нужно пометить класс сервиса атрибутом MimeType и в нем указать к какой метод какой тип информации должен возвращать. В итоге можем получить следующую операцию:
[MimeType(\"Help\", \"text/html\")]\npublic class NorthwindService : DataService<NorthwindEntities>\n{\n [SingleResult]\n [WebGet]\n public string Help()\n {\n return @\"<html>...</html>\";\n }\n\n // ...\n}Кстати, не обязательно возвращать строку, можно вернуть например бинарный поток, в этом случае в качестве типа возвращаемого значения будет Stream.
Однако, с операциями, которые возвращают не IQueryable существует одна досадная неприятность. Дело в том, что если мы вернем например строку, и обратимся к этому методу как обычно, то результат будет обернут в XML. Для того, чтобы получить тот же самый HTML, который мы хотим получить, необходимо обратиться к операции, используя ключевое слово $value.
http://../Service.svc/Help/$valueТеперь, на выходе мы получим HTML-код и заголовок ContentType будет содержать правильное значение. Точно также дела обстоят с бинарными данными, например картинками.
В последнее время, когда данные все чаще представляют в виде объектных моделей время от времени появляются разговоры о навигации по связанным сущностям. Т.е. с точки зрения модели данных есть две коллекции, сущности которых ссылаются друг на друга, и технологии, которые позволяют работать с моделями данных так или иначе стараются решить проблемы навигации/перехода от одной сущности к другой.
\nСейчас я бы хотел поговорить о том, каким образом это реализуется в технологии ADO.NET Data Services. ADO.NET Data Services – это платформа, которая позволяет предоставить доступ к данным в Web по протоколу HTTP в REST-стиле.
\nСоответственно, когда на клиентской стороне мы получаем доступ к какой-либо модели данных, полученной от ADO.NET Data Services, задача навигации между сущностями кажется совершенно нормальной. ADO.NET Data Services предлагает два варианта решения этой задачи:
\n$expand при выполнении запроса.LoadProperty().Давайте посмотрим в чем разница.
\nПри использовании ключевого слова $expand мы явно при выполнении запроса указываем какие связанные контейнеры объектов хотим получить. Например, у нас есть таблица Customers и связанная с ней таблица Orders. В этом случае мы можем осуществить следующий запрос:
http://.../Service.svc/Customers/?$expand=OrdersВ этом случае в рамках одного запроса к серверу (round-trip) будет получена коллекция Customers (например, в виде AtomPub) и для каждой сущности Customer будут представлены объекты Order. Таким образом, на клиентской стороне после выполнения такого запроса и навигации от объекта Customer к объектам Order запросов больше выполняться не будет – все нужные данные уже загружены. Для того, чтобы клиентский прокси-класс включил в генерируемый URI ключевое слово Expand необходимо воспользоваться одноименным extension-методом. Вот как может выглядеть код клиентского приложения:
var context = new NorthwindService.NorthwindEntities(new Uri(@\"http://../Service.svc\"));\nvar query = context.Customers.Expand(\"Orders\");\nforeach (var customer in query)\n{\n Console.WriteLine(customer.CompanyName);\n foreach (var order in customer.Orders)\n {\n Console.Write(order.OrderID);\n }\n Console.WriteLine();\n}Однако, такой подход хорош только тогда, когда мы точно знаем что данные из связанной коллекции нам будут нужны. Если при перемещенни по коллекции Customers данные о заказах (Orders) нам нужны только в небольшом количестве случаев, то возможно нету большого смысла загружать все данные из связанной коллекции Orders. В этом случае мы можем прибегнуть ко второму способу – использованию метода LoadProperty().
При вызове метода LoadProperty() будет осуществляться отдельный round-trip к сервису для получения только тех объектов Orders, которые связаны с текущим объектом Customer. Таким образом, мы можем не использовать Expand для нашего запроса, а тогда, когда нам будут необходимы данные из связанной коллекции мы можем обратиться к методу LoadProperty() и после исполнения запроса получить необходимые данные. Вот как может выглядеть код клиентского приложения в этом случае:
var context = new NorthwindService.NorthwindEntities(new Uri(@\"http://../Service.svc\"));\nvar query = context.Customers; //.Expand(\"Orders\")\nforeach (var customer in query)\n{\n Console.WriteLine(customer.CompanyName);\n\n // определенные условия\n if (..)\n {\n context.LoadProperty(customer, \"Orders\");\n\n foreach (var order in customer.Orders)\n {\n Console.Write(order.OrderID);\n Console.Write(\" \");\n }\n }\n Console.WriteLine();\n}Понятно, что оба варианта по своему хороши. Если мы точно знаем что каждый раз будем работать со связанной коллекцией, то нет смысла генерировать большое количество запросов к сервису — в этом случае проще получить все за один запрос; в случае если данные из связанных коллекций нужны далеко не всегда, то в этом случае можно подгружать их только тогда, когда это необходимо и не генерировать огромный ответ, который включает по сути две коллекции, хотя это вовсе не обзятельно.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2008/adonet-data-services-expand/58c1655b/adonet_data-services-expand@cover.jpg" }, { "id": "https://blog.zwezdin.com/2008/linqpad/", "url": "https://blog.zwezdin.com/2008/linqpad/", "title": "LINQPad", "date_published": "2008-12-01T13:00:00.000Z", "content_html": "Набрел сегодня в пространствах Интернета на достаточно интересный инструмент — LINQPad.
\nСама по себе она достаточно простая. Но в то же время можно “по быстрому” опробовать возможности LINQ и строить какие-то запросы. Тем не менее, не смотря на её простоту она умеет работать с LINQ to SQL, LINQ to Objects и LINQ to XML, хотя я успел попробовать только первое.
\n\n\n\n![\"LINQPad\"/](\"https://blog.zwezdin.com/2008/linqpad/0d2a5df9/1@2x.png\")
\n\n\n\n\nРаспространяется LINQPad бесплатно, а размер всего 2Mb.
", "tags": [ "Tools", "LINQ" ], "banner_image": "https://blog.zwezdin.com/2008/linqpad/9b6e7fc9/linqpad@cover.png" }, { "id": "https://blog.zwezdin.com/2008/snippet-designer/", "url": "https://blog.zwezdin.com/2008/snippet-designer/", "title": "Snippet Designer", "date_published": "2008-11-22T13:00:00.000Z", "content_html": "Достаточно часто встречаются ситуации, когда какой-то кусок кода хочется оформить в сниппет и пользоваться им в будущем, но тратить драгоценное время на написание XML-описания очень не хочется. Так бывает например при разработке приложений или при подготовке к презентации с демо, в которой много кода.
\nВ силу указанных причин ранее я не писал сниппеты, а нужные куски кода просто перетаскивал в Toolbox у Visual Studio. Такой подход работает в презентациях/демонстрациях, но разрабатывать реальное приложения исопльзуя такой подход очень тяжело.
\nОказывается существует замечательный плагин для Visual Studio 2008 – Snippet Designer. Этот плагин позволяет буквально в несколько нажатий мышки создать нужный сниппет и разместить его в нужном месте.
\nДавайте посмотрим как работает Snippet Designer. После установки Snippet Designer сделаем следующие шаги.
\nШаг 1: Для начала создадим пустой проект и в нем напишем некий код. После этого выделим нужный участок и в контекстном меню выберем пункт Export as snippet.
![\"Snippet](\"https://blog.zwezdin.com/2008/snippet-designer/251a4a63/1@2x.png\")
\n\n\n\n\nШаг 2: После этого откроется окно редактирования сниппета. Выберем нужные участки в коде и с помощью контекстного меню сделаем их заменяемыми.
\n\n\n\n![\"Snippet](\"https://blog.zwezdin.com/2008/snippet-designer/73cd6d01/2@2x.png\")
\n\n\n\n\nПосле этого в нижней части окна появятся все заменяемые части. Там для каждой части мы можем задать текст подсказки, значение по умолчанию, тип и т.д.
\n\n\n\n![\"Snippet](\"https://blog.zwezdin.com/2008/snippet-designer/c9ae40b1/3@2x.png\")
\n\n\n\n\nШаг 3: После этого у сниппета можно задать свойства. Для этого используется окно Properties. Там мы можем задать различные параметры. Самый главный – это параметр Shortcut.
![\"Snippet](\"https://blog.zwezdin.com/2008/snippet-designer/9e351019/4@2x.png\")
\n\n\n\n\nШаг 4: После этого сохраняем наш сниппет и он становится доступным для использования.
\n\n\n\n![\"Snippet](\"https://blog.zwezdin.com/2008/snippet-designer/1cd5c181/5@2x.png\")
\n\n\n\n\nВот такой вот интересный плагин. Что приятно, проект размещен на CodePlexGithub вместе с исходным кодом и распространяется бесплатно.
Одной из наиболее важной особенностью .NET 4.0 является поддержка динмаического типа. Давайте посмотрим что это такое.
\nПоддержка динамического типа стала возможной благодаря появлению ключевого слова dynamic. При объявлении динамического объекта можно обращаться к любому члену класса, при этом заранее не зная что это за класс (не зная типа). Например так:
static void DynamicMethod(object someObject)\n{\n dynamic dynamicObject = someObject;\n dynamicObject.MyMethod();\n}В этом примере мы видим, что в метод приходит объект неизвестного нам типа и теперь, используя ключевое слово dynamic, мы можем вызывать любые методы и обращаться к любым свойствам объекта.
На самом деле в недрах .NET 4.0 для такой конструкции используется Reflection и поиск нужного члена класса с немного хитрым алгоритмом (кэшированием), но не будем о нем сейчас. Как вы понимаете, если у вызываемого объекта нету такого члена, то получим исключение в runtime. Поэтому нужно быть с dynamic осторожнее.
Что можно сделать еще? Можно передавать динамические объекты как параметр метода. Таким образом становится возможным передать в метод например объект анонимного типа.
\nstatic void Main(string[] args)\n{\n DynamicMethod2(new { Id = 5, Name = \"1234\" });\n}\n\nstatic void DynamicMethod2(dynamic someObject)\n{\n Console.WriteLine(someObject.Name);\n}Соответственно, этот код работает аналогично. Такие возможности .NET4.0 в первую очередь ориентированы на динамические языки и позволят работать с ними очень хорошо. Например, можем взять JSON-описание объекта и превратить его в нормальный объект .NET и с ним уже работать.
\nНу и точно также мы можем вернуть динамический объект, например анонимный:
\nstatic dynamic DynamicMethod3()\n{\n return new { Id = 555 };\n}Я уже рассказывал о том, что для построения веб-сервисов, кроме наиболее популярного подхода SOAP, существует другой подход – REST. Очень удачной для реализации REST-сервисов является технология ADO.NET Data Services. Однако, для построения REST-сервисов мы также можем воспользоваться и Windows Communication Foundation. Давайте посмотрим каким образом.
\nПрежде чем рассматривать инструменты для построения REST-сервисов WCF, давайте вспомним отличительные черты таких сервисов.
\nЛюбой веб-сервис на базе REST:
\nЕсли к 1) и 3) пункту вопросов не возникает, то видно что 2) пункт явно не укладывается в идеологию WCF в том виде, в котором она существовала ранее. Т.е. если ранее мы могли как-то адресовать веб-сервисы, то на каждый URI нужно было описать публичный контракт и создать сервис. Однако, для REST-сервисов это критичный момент. Поэтому для реализации такой поддержки в составе WCF .NET Framework 3.5 появился целый HTTP API, который призван решить эти и другие проблемы.
\nВ рамках HTTP API существуют такие важные классы как UriTemplate, UriTemplateMatch и UriTemplateTable. Именно этот набор классов позволяет осуществить маппинг конкретных URI на нужные операции. Несмотря на то, что эти объекты напрямую мы не используем, я думаю будет очень полезно для общего понимания посмотреть как они работают. Для этого давайте посмотрим следующий пример:
Uri address = new Uri(\"http://localhost:8000\");\nUriTemplate template = new UriTemplate(\"{category}/{product}\");\nUri boundUri = template.BindByPosition(address, \"notebooks\", \"lenovo-t61\");\nConsole.WriteLine(address.ToString()); // http://localhost:8000/notebooks/lenovo-t61Как видно, здесь мы задаем некий базовый URI и шаблон URI. Далее, используя полученный шаблон можно задать значение секций, которые определены в шаблоне. Как видим, в результате мы получаем URI вида http://localhost:8000/notebooks/lenovo-r61. Понятно, что если мы просто изменим шаблон URI, например, на shop/{category}/{product}/info, то в результате получим http://localhost:8000/shop/notebooks/lenovo-r61/info” И так далее. Дальше, используя класс UriTemplateMatch можно выполнить обратную операцию – по полученному URI и шаблону получить значение конкретных секций (в данном примере - category, product).
Как я уже говорил, эти объекты мы не используем напрямую, тем не менее они используются при маппинге URI на конкретную операцию.
\nТеперь, когда мы знаем как осуществляется маппинг, давайте рассмотрим каким образом можно построить REST-сервис на базе WCF. Для этого очень удобно пользоваться стандартным шаблоном при созданни проекта в VS2008 Syndication Service Library. Конечно, это не обязательное условие.
Построение публичного контракта. Для создания любого WCF-сервиса в первую очередь необходимо создать для него публичный контракт. REST-сервисы на базе WCF не исключение. Стандартный контракт в WCF для REST-сервиса выглядит следующим образом:
\n[ServiceContract]\n[ServiceKnownType(typeof(Atom10FeedFormatter))]\n[ServiceKnownType(typeof(Rss20FeedFormatter))]\npublic interface IFeed1\n{\n [OperationContract]\n [WebGet(UriTemplate = \"*\")]\n SyndicationFeedFormatter CreateFeed();\n\n // TODO: Add your service operations here\n}В таком контракте, кроме стандартных атрибутов ServiceContract и OperationContract мы видим одно нововведение – атрибут WebGet. Именно с помощью этого атрибута мы можем указать какой URI соответствует какой операции. В приведенном примере все URI отображаются на единственную операцию — CreateFeed(). Давайте этот пример несколько модифицируем:
[ServiceContract]\n[ServiceKnownType(typeof(Atom10FeedFormatter))]\n[ServiceKnownType(typeof(Rss20FeedFormatter))]\npublic interface IFeed1\n{\n [OperationContract]\n [WebGet(UriTemplate = \"authors\")]\n SyndicationFeedFormatter AuthorsFeed();\n\n [WebGet(UriTemplate = \"authors/{author}\")]\n SyndicationFeedFormatter AuthorsFeed(string author);\n}Теперь, в таком сервисе мы можем использовать два вида URI: ../feed1/authors и ../feed1/authors/<имя автора>. Причем при вызове того или иного URI, WCF автоматически определит какую операцию нужно вызвать, а во втором случае еще и передаст нужные параметры в метод (которые извлекаются из самого URI, помним объект UriTemplateMatch из HTTP API). Подобным образом мы можем создать нужное количество операций и определить для них те URI, которые нам необходимы.
Теперь давайте обратим внимание на тип возвращаемого операцией значения. В данном случае мы возвращаем некую ленту (feed). В поставке .NET 3.5 существуют два стандартных форматировщика – для RSS 2.0 и AtomPub 1.0. Однако, никто не мешает нам написать свои собственные форматировщики :).
\nЯ уже говорил о том, что в рамках такого сервиса мы можем возвращать не только XML, но и вообще говоря любые данные, например, картинку. Для этого мы можем изменить контракт следующим образом:
\n[ServiceContract]\n[ServiceKnownType(typeof(Atom10FeedFormatter))]\n[ServiceKnownType(typeof(Rss20FeedFormatter))]\npublic interface IFeed1\n{\n [OperationContract]\n [WebGet(UriTemplate = \"authors\")]\n SyndicationFeedFormatter AuthorsFeed();\n\n [WebGet(UriTemplate = \"authors/{author}\")]\n SyndicationFeedFormatter AuthorsFeed(string author);\n\n [WebGet(UriTemplate = \"authors/photo/{author}\")]\n Stream AuthorPhoto(string author);\n}В данном случае мы видим, что добавилась еще одна операция со своим URI, которая возвращает Stream. Внутри этого потока может быть что угодно, в т.ч. картинка.
\nКонтракт готов, давайте перейдем к реализации самого сервиса. Собственно, сам сервис – это класс, реализующий наш публичный контракт. Здесь самое время поговорить об объектах SyndicationFeed и SyndicationItem – это объекты, являющются абстракциями ленты (feed) и ее содержимого. Наличие таких объектов позволяет нам не думать о конкретном формате ленты (RSS, Atom или еще что), а просто создать содержимое нашей ленты. Таким образом, метод AuthorsFeed() может выглядеть следующим образом:
public SyndicationFeedFormatter AuthorsFeed()\n{\n SyndicationFeed feed = new SyndicationFeed(\"Feed Title\", \"A WCF Syndication Feed\", null);\n\n List<SyndicationItem> items = new List<SyndicationItem>();\n items.Add(new SyndicationItem(\"Author1\", \"Author1. Age: 23.\", null));\n items.Add(new SyndicationItem(\"Author2\", \"Author2. Age: 26.\", null));\n\n feed.Items = items;\n\n return new Rss20FeedFormatter(feed);\n}Как видно, здесь мы создаем ленту, наполняем ее содержимым и возвращаем конкретный форматировщик – в данном случае форматировщик RSS 2.0. Если мы хотим работать с AtomPub, можно несколько изменить реализацию метода:
\npublic SyndicationFeedFormatter AuthorsFeed()\n{\n SyndicationFeed feed = new SyndicationFeed(\"Feed Title\", \"A WCF Syndication Feed\", null);\n\n // наполнение ленты содержимым\n\n return new Atom10FeedFormatter(feed);\n}Поскольку при реализации REST-сервиса мы имеем дело с HTTP, то мы можем оперировать с различными HTTP-сущностями, например HTTP-заголовками или GET-параметрами. Сделать это можно, используя объект WebOperationContext, который также входит в состав HTTP API. Таким образом, мы можем на основе значения GET-параметра выбирать нужный форматировщик:
public SyndicationFeedFormatter AuthorsFeed()\n{\n SyndicationFeed feed = new SyndicationFeed(\"Feed Title\", \"A WCF Syndication Feed\", null);\n\n // ...\n\n string query = WebOperationContext.Current.IncomingRequest.UriTemplateMatch.QueryParameters[\"format\"];\n\n if (query == \"atom\")\n {\n return new Atom10FeedFormatter(feed);\n }\n else\n {\n return new Rss20FeedFormatter(feed);\n }\n}Точно также можно работать, например с HTTP-заголовками.
\nОднако, в рамках нашего REST-сервиса мы можем возвращать не только ленту, но и, как я уже упоминал, любые другие данные. Например изображение:
\npublic Stream AuthorPhoto(string author)\n{\n MemoryStream result = new MemoryStream();\n\n // заполнение потока\n\n WebOperationContext.Current.OutgoingResponse.ContentType = \"image/jpeg\";\n\n return result;\n}Обратите внимание, в данном случае кроме того, что мы возвратили поток нужно установить значение HTTP-заголовка Content-Type. Это можно осуществить используя объект WebOperationContext. Подобным образом можно вернуть, например, некий html-код или что-то еще.
Мы посмотрели на то, каким образом мы можем предоставить доступ к данным в рамках нашего REST-сервиса. Однако, REST-подход предполагает не только получение данных, но и их модификацию. Для этого используются HTTP-методы POST, PUT и DELETE. Для того, чтобы реализовать это в рамках сервиса, необходимо пометить нашу операцию в рамках публичного контракта атрибутом WebInvoke, вместо WebGet. При этом потребуется указать какой метод используется (свойство Method) и шаблон URI, на который отображается наша операция. В остальном реализация метода зависит от семантики операции. Например, мы можем что-то изменить в нашем источнике.
Не смотря на большое количество текста, получившегося при написании поста, реализация REST-сервиса на базе WCF вовсе не сложное занятие. Заканчивая, хочется подвести небольшой итог. Если у нас есть некая объектая модель данных (будь то концептуальная модель Entity Framework или модель LINQ to SQL, либо что-то еще), то несомненно реализовать REST-сервис будет проще на базе ADO.NET Data Services. WCF Syndication имеет смысл использовать в тех сценариях, где данные не очень удобно представлять в виде объектных структур. Например, если мы хотим предоставить доступ к каким-то файлам в рамках файловой системы, удобнее будет построить REST-сервис на базе WCF. Т.о. используя WCF мы можем реализовывать более глубокие сценарии, нежели просто предоставление доступа к модели данных через Web.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2008/wcf-rest/acc42669/wcf_rest@cover.jpg" }, { "id": "https://blog.zwezdin.com/2008/wpf-bindings/", "url": "https://blog.zwezdin.com/2008/wpf-bindings/", "title": "Bindings в WPF", "date_published": "2008-09-11T12:00:00.000Z", "content_html": "Разработчики, которые уже успели поработать с технологией WPF очень хорошо знакомы с таким механизмом как Bindings. Обычно этот механизм ассоциируют с привзякой одного свойства элемента управления к другому или с привязкой к каким-то коллекциям данных. Однако, этими сценариями Bindings не ограничиваются. Давайте посмотрим в каких еще сценариях мы можем применять привязки.
\nПредположим, в рамках нашего приложения существует некий слой, который является источником данных для нашего пользовательского интерфейса. Этот слой может быть реализован различным образом - начиная от простого статического класса, заканчивая неким сервисом с публичным контрактом и сложной логикой инстанциации. В любом из этих сценариев мы можем декларативно осуществить привязку к этому объекту.
\nВозьмем для примера класс Settings, который генерирует Visual Studio при задании каких-либо конфигурационных параметров. Получить экземпляр этого класса с заполненными данными можно получить через публичное статическое свойство Default:
internal sealed partial class Settings : global::System.Configuration.ApplicationSettingsBase\n{\n public static Settings Default\n {\n get\n {\n return defaultInstance;\n }\n }Далее в этом классе определяются публичные поля, соответствующие настройкам нашего приложения. В демонстрационном примере я создам одну настройку Param1. Таким образом, в составе данного класса появится нужное свойство:
public string Param1\n{\n get\n {\n return ((string)(this[\"Param1\"]));\n }\n set\n {\n this[\"Param1\"] = value;\n }\n}После этого, мы можем, например, императивно обратится к этому свойству и присвоить его значение какому-то элементу управления:
\nText1.Text = Settings.Default.Param1;Однако, эту же функциональность можно задать декларативно используя XAML:
\n<TextBox Name=\"Text1\" Text=\"{Binding Source={x:Static config:Settings.Default}, Path=Param1}\"/>Как мы видим, здесь в качестве источника указывается статическое свойство класса, а в параметре Path указывается имя свойства уже инстанциированного класса. Кроме отображений настроек класса Settings очень удобно пользоваться Bindings для изменения этих настроек, для этого используется режим двунаправленного Binding:
<TextBox Name=\"Text1\" Text=\"{Binding Source={x:Static config:Settings.Default}, Path=Param1, Mode=TwoWay}\"/>Как вы понимаете, подобным образом мы можем обращаться не только к Settings, но и к любым другим классам, например DateTime:
<TextBox Name=\"Text2\" Text=\"{Binding Source={x:Static System:DateTime.Now}, Path=DayOfYear, Mode=OneWay}\"/>Здесь как мы видим используется режим однонаправленного связывания (Mode=OneWay), т.к. свойство DayOfYear класса DateTime предназанчено только для чтения.
Подобным образом можно привязывать не только единичные значения свойств, но и работать с коллекциями. Например, определим класс, который возвращает некую коллекцию:
\npublic class DataSource1\n{\n public static DataSource1 Default\n {\n get { return new DataSource1(); }\n }\n\n public IEnumerable List1\n {\n get { return GetType().GetMethods(); }\n }\n}Тогда привязка к элементу ListBox будет выглядеть следующим образом:
<ListBox Name=\"List1\" ItemsSource=\"{Binding Source={x:Static WpfApplication38:DataSource1.Default}, Path=List1, Mode=OneWay}\" />Другой сценарий — класс, поставляющий нам данные не имеет статического свойства, поставляющего нам инстанс класса. В этом случае мы можем объявить этот класс в ресурсах, при этом при созданни экземпляра окна будет создан один инстанс такого класса, который будет обслуживать все последующие запросы:
\n<Window.Resources>\n <WpfApplication38:DataSource1 x:Key=\"Source1\"/>\n</Window.Resources>\n...\n<ListBox Name=\"List2\" ItemsSource=\"{Binding Source={StaticResource Source1}, Path=List1, Mode=OneWay}\" />Кроме того, класс, к данным которого мы хотим привязать значение элемента управления вообще может быть статическим:
\npublic static class DataSource2\n{\n public static string Data1 { get; set; }\n public static string Data2 { get; set; }\n}В таком случае мы также можем определить привязку декларативно:
\n<TextBox Name=\"Text3\" Text=\"{Binding Source={x:Static WpfApplication38:DataSource2.Data1}, Mode=OneWay}\"/>\n<TextBox Name=\"Text4\" Text=\"{Binding Source={x:Static WpfApplication38:DataSource2.Data2}, Mode=OneWay}\"/>Хорошо, со свойствами разобрались. Однако, очень часто бывает так, что данные нам передаются не через свойства, а посредством вызова методов. В этом случае все сложнее, не не на много :).
\nДля того, чтобы определить связь с данными, возвращаемыми методом существует объект ObjectDataProvider. Он позволяет указать класс, в котором содержится метод, инстанциировать его если нужно и вызвать метод. Например у нас существует класс, в котором определен метод, возвращающий данные:
public class DataSource1\n{\n //...\n\n public string GetData1()\n {\n return Guid.NewGuid().ToString();\n }\n}Для того, чтобы получить возможность определения Binding на основе такого класса в XAML-коде необходимо определить ObjectDataProvider и указать в нем имя класса и имя вызываемого метода:
<Window.Resources>\n <ObjectDataProvider x:Key=\"Source2\"\n ObjectType=\"{x:Type WpfApplication38:DataSource1}\"\n MethodName=\"GetData1\">\n\n </ObjectDataProvider>\n</Window.Resources>После этого, можно ссылаться на Source2 в качестве источника:
<TextBox Name=\"Text5\" Text=\"{Binding Source={StaticResource Source2}, Mode=OneWay}\"/>Точно также в качестве результата работы метода можно вернуть не просто какой-то простой тип, но и объект или коллекцию:
\npublic class DataSource1\n{\n // ...\n\n public object GetData2()\n {\n return new\n {\n Value1 = Guid.NewGuid().ToString(),\n Value2 = DateTime.Now.ToString()\n };\n }\n\n public IEnumerable GetData3()\n {\n return GetType().GetMethods();\n }\n}И создать привязку к ним:
\n<Window.Resources>\n <ObjectDataProvider x:Key=\"Source3\"\n ObjectType=\"{x:Type WpfApplication38:DataSource1}\"\n MethodName=\"GetData2\"/>\n\n <ObjectDataProvider x:Key=\"Source4\"\n ObjectType=\"{x:Type WpfApplication38:DataSource1}\"\n MethodName=\"GetData3\"/>\n</Window.Resources>\n\n...\n\n<TextBox Name=\"Text6\" Text=\"{Binding Source={StaticResource Source3}, Path=Value1, Mode=OneWay}\"/>\n<ListBox Name=\"List3\" ItemsSource=\"{Binding Source={StaticResource Source4}, Mode=OneWay}\" />Ну и наконец мы можем передавать значения параметров методов, если метод содержит параметры. Для этого мы можем использовать коллекцию MethodParameters объекта ObjectDataProvider:
<Window.Resources>\n ...\n <ObjectDataProvider x:Key=\"Source5\"\n ObjectType=\"{x:Type WpfApplication38:DataSource1}\"\n MethodName=\"GetData4\">\n <ObjectDataProvider.MethodParameters>\n <System:String>qwerty</System:String>\n </ObjectDataProvider.MethodParameters>\n </ObjectDataProvider>\n</Window.Resources>Понятно, что аналогичным образом мы можем добавить несколько параметров в вызов метода.
\nUPDATE (спасибо Виталию Дильмухаметову):
Если в качестве параметра нужно передать тип (typeof(...)), это можно сделать так:
<ObjectDataProvider x:Key=\"GetMembers\"\n ObjectType=\"{x:Type WpfApplication34:EnumService}\"\n MethodName=\"GetResult\">\n <ObjectDataProvider.MethodParameters>\n <x:Type TypeName=\"WpfApplication34:MyEnum\"/>\n </ObjectDataProvider.MethodParameters>\n</ObjectDataProvider>При этом вызываемый метод может выглядеть следующим образом:
\npublic class EnumService\n{\n public static IEnumerable<string> GetResult(Type type)\n {\n return from f in type.GetFields(BindingFlags.Public | BindingFlags.Static) select f.Name;\n }\n}Тогда в качестве значения параметра будет передано typeof(WpfApplication34.MyEnum).
Таким образом, мы видим, что имеем возможность получить доступ к данным, которые представлены через вызов методов класса.
\nТакие вот преимущества мы получаем используя подход декларативного связывания данных, который появился в WPF. В противовес этому, при использовании WinForms нам предлагается написать много императивного кода, особенно когда нужно реализовать сценарий двунаправленного связывания. Понятно как это скажется на читаемости кода и поддержке/развитии приложения. :)
", "tags": [ "WPF", "XAML" ], "banner_image": "https://blog.zwezdin.com/2008/wpf-bindings/c54b49c0/wpf_bindings@cover.jpg" }, { "id": "https://blog.zwezdin.com/2008/adonet-data-services-introduction/", "url": "https://blog.zwezdin.com/2008/adonet-data-services-introduction/", "title": "Знакомство с ADO.NET Data Services", "date_published": "2008-08-18T12:00:00.000Z", "content_html": "Не так давно я рассказывал о двух взаимозаменяющих взаимодополняющих подходах к построению сервисов — SOAP и REST. На этот раз мы поговорим о технологии, которая позволит нам с легкостью строить REST-сервисы — ADO.NET Data Services.
Итак, вспомним еще раз о том, что сервис в стиле REST позволяет нам работать с данными. Это означает, что алгоритм построения сервис-ориентированной системы на базе REST будет примено следующим:
\nТеперь можно перейти к делу.
\nВ своем примере я использую VS2008SP1 + SQL Server 2008. В качестве источника данных возьмем Entity Data Model (ADO.NET Entity Framework).
\nДля того, чтобы иметь возможность работать с ADO.NET Data Services необходимо установить ASP.NET 3.5 Extensions, либо VS2008SP1 + .NET3.5SP1.
\nПервым делом создадим веб-приложение ASP.NET. Добавим в наше приложение Entity Data Model. В качестве источника пусть будет база данных Northwind.
![\"Знакомство](\"https://blog.zwezdin.com/2008/adonet-data-services-introduction/f7b10ae0/1@2x.png\")
\n\n\n\n\nПри создании модели скажем мастеру использовать все таблицы БД, получится симпотичная модель базы Northwind.
После того как источник данных готов к работе добавим в наш проект сервис. Для этого еще раз обратимся к пункту меню Add new item и из предложенных шаблонов выберем пункт ADO.NET Data Service. В итоге среда разработки создаст нам заготовку класса-сервиса. Этот класс - наследник от WebDataService<..>, который в качестве generic-параметра использует тип источника данных:
public class WebDataService1 :\n WebDataService< /* TODO: put your data source class name here */ >\n {\n ...Для того, чтобы наш сервис заработал, укажем в качестве generic-параметра контекст нашего источника данных (DataClasses1Context):
public class WebDataService1 :\n WebDataService<DataClasses1Context>\n {Следующим шагом необходимо определить видимость контейнеров для клиентов. Дело в том, что ADO.NET Data Services позволяет на уровне контейнера разграничить права доступа - одни контейнеры мы, например, можем только читать (read only), по другим - выполнять запросы и читать, а третьи - изменять.
\nВ данный момент разрешим все для всех контейнеров. Для этого изменим статический метод InitializeService(..) и добавим к нему следующий код:
public static void InitializeService(IWebDataServiceConfiguration config)\n{\n config.SetResourceContainerAccessRule(\"*\", ResourceContainerRights.All);\n}Кроме того, что мы можем ограничить доступ к данным на уровне контейнеров, можно управлять правами на уровне операций, а также создавать свои перехватчики (interceptors). Но об этом в следующий раз.
Собственно на этом создание сервиса завершено. Теперь мы можем обратиться к нему из браузера и посмотреть что из этого получилось. В результате мы увидим наши коллекции в формате AtomPub.
Но нет толку от сервиса, когда нету клиента. Давайте реализуем клиента. Задача реализации клиента сводится к построению прокси-класса к нашему сервису. Для этого служит утилита WebDataGen. Для того, чтобы она сгенерировала нам прокси-класс запустим наш сервис и запустим webdatagen:
\"C:\\Program Files (x86)\\Microsoft ASP.NET 3.5 Extensions\\Webdatagen.exe\" /uri:http://localhost:51126/NorthwindService.svc /language:CSharp /outobjectlayer:./NorthwindService.cs /mode:ClientClassGenerationВ результате работы WebDataGen получим файл NorthwindService.cs, который и содержит прокси-класс. Далее мы можем использовать этот класс где угодно — от консольных до WPF-приложений. При этом нам останется только указать адрес, по которому расположен сервис:
NorthwindDataClasses context =\n new NorthwindDataClasses(@\"http://localhost:51126/NorthwindService.svc\");\n\nvar q = from c in context.Customers\n select c;Теперь наша база данных Northwind доступна через REST-сервис.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2008/adonet-data-services-introduction/d29eb381/adonet_data-services-introduction@cover.jpg" }, { "id": "https://blog.zwezdin.com/2008/soap-vs-rest/", "url": "https://blog.zwezdin.com/2008/soap-vs-rest/", "title": "REST vs. SOAP/WS-*", "date_published": "2008-08-14T12:00:00.000Z", "content_html": "На сегодняшний день одним из важнейших направлений в области разработки ПО является направление (веб)-сервисов. Сервисы позволяют строить большие распределенные системы. При этом подходов к построению сервисов сегодня как минимум два - SOAP и REST.
\nОба подхода решают схожие задачи - задачи построения распределенных систем. Но делают это по-разному.
\nВ случае с SOAP/WS-* фактически мы имеем дело с выполнением операций на удаленном хосте. Обмениваясь SOAP-сообщениями, клиент фактически “просит” сервера выполнить ту или иную операцию, передавая ему при этом параметры (если это необходимо). В ответ на это, сервер отправляет клиенту SOAP-сообщение, в котором содержится - либо отметка об успешном выполнении операции и результат, либо сообщение об ошибке.
\nКроме того, передавать SOAP-сообщения можно потенциально через любой транспорт (WCF, например, умеет это делать поверх http, tcp, named pipes, msmq, …).
\nВ итоге, SOAP-ориентированный подход фактически подталкивает нас к ориентации на операции.
\nСтоит отметить, что сегодня подавляющее большинство программных продуктов, ориентированных на сервисы используют SOAP в качестве основы.
\nПодход в стиле REST отличается от SOAP тем, что такой сервис ориентирует нас на работу с данными. Предоставив REST-сервис, мы фактически публикуем данные (коллекции) в Веб.
\nREST обладает следующими отличительными чертами:
\nGET, POST, PUT, DELETE), а данные передаются в теле HTTP-сообщений.AtomPub, JSON, ..)Кроме того, отмечу что REST-сервисы не выходят за рамки HTTP, а это означает, что мы можем использовать все наработанные алогритмы в области веб-приложений - кэширование, сжатие трафика, аутентификация и т.д.
\nИ итоге, REST-ориентированный подход подталкивает нас к ориентации на данные.
\nРазница между REST и SOAP достаточно очевидная и очень важно понимать значение того и другого подхода и использовать каждый из них по назначению. :) Как показывает моя практика общения с различными разработчиками, такое понимание есть далеко не у всех.
\nДавайте посмотрим пару примеров, чтобы понять какой подход выбрать в конкретной ситуации на практике.
\nПример 1. Мы хотим разработать серивс-ориентированное приложение для работы с банковским счетом. В сервисе будут 2 бизнес-операции: получить текущий остаток на счету и списать денежные средства. При этом для выполнения операции списания мы должны обратится к локальной СУБД под управлением Microsoft SQL Server, продублировать эту же операцию на мэйнфрейме и отправить уведомление на дублирующий сервер по протоколу TCP. Этот пример ярко демонстрирует ориентацию на операции: для того чтобы списать сумму со счета необходимо выполнить целую цепочку действий. Понятно, что для такого сервиса мы выберем сервисы на базе SOAP.
\nПример 2. У нас есть существующая B2C (business to customers) система - веб-приложение, которым пользуются наши любимые клиенты. И тут мы понимаем, что клиентам было бы гораздо удобнее размещать свои каталоги в нашей системе используя настольное приложение, а не веб. Принимается решение создать веб-сервис, через который настольное приложение будет работать с источником данных. Если посмотреть на данный веб-сервис, то мы понимаем, что все что он делает - работает с данными: добавить позицию, редактировать позицию, удалить позицию и получить список всех позиций. Реализация SOAP-сервиса в данном случае избыточна (нам не требуется выполнять бизнес-операции). Для решения задачи идеально подходит решение на базе REST - на сервере мы просто получаем от источника данные, публикуем их в веб и отдаем клиенту URI. Никаких нудных реализаций AddItem(..), UpdateItem(..) и т.д.
Ну и напоследок о технологиях. Решения на базе SOAP/WS-* позволяют реализовывать множество технологий - ASP.NET Web Services, WSE и конечно WCF.
\nРешения на базе REST можно удобно построить на базе ADO.NET Data Services (т.н. Project Astoria). Кроме того, для кого-то наверное окажется новостью, но WCF также умеет строить REST-style сервисы, но об этом позже.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2008/soap-vs-rest/ce8e742e/soap_vs-rest@cover.jpg" }, { "id": "https://blog.zwezdin.com/2008/linq2sql-sqlcompact/", "url": "https://blog.zwezdin.com/2008/linq2sql-sqlcompact/", "title": "LINQ to SQL и SQL Server Compact Edition", "date_published": "2008-07-14T12:00:00.000Z", "content_html": "В последнее время на различных мероприятиях для разработчиков мы часто слышим много новых и модных красивых слов. К таковым, например, относятся LINQ и SQL Server Compact Edition.
\nКак вы уже знаете, LINQ - это типизированный язык запросов к любым источникам данных. Используя LINQ мы строим строго типизированный запрос, который проверяется на этапе компиляции, получаем строго типизированные результаты и т.д.; при этом эти запросы мы строим единообразно будь источником данных у нас SQL Server, либо коллекция объектов.
\nSQL Server Compact Edition (SSCE) — тоже многообещающая технология. Фактически это in-proc мини-engine баз данных, который поддерживает T-SQL, не требует установки и может работать как на desktop-, так и на mobile-приложениях.
\nОбе технологии, несомненно интересные и многообещающие. Так, например, все очень хорошо понимают сколько времени можно сэкономить на построении уровня данных, используя LINQ. С другой стороны для небольших приложений использование SSCE позволяет сэкономить много времени при развертывании.
\nКонечно, напрашивается решение использовать эти две технологии совместно, но не тут то было :) При попытке добавить в проект "LINQ to SQL Classes" (.dbml), и замапить их на источник данных SSCE получаем ненавязчивое сообщение.
![\"LINQ](\"https://blog.zwezdin.com/2008/linq2sql-sqlcompact/835f2942/error@2x.png\")
\n\n\n\n\nНда.. не очень, конечно, приятно. Но выход есть - использование утилиты SqlMetal. Эта утилита представляет собой консольное приложение, которое по существующей схеме данных позволяет сгенерировать dbml-файл. Собственно, утилита работать может как с обычным SQL Server, так и с SSCE, что нам и нужно. В случае с SSCE использовать ее очень просто:
SqlMetal /dbml:northwind.dbml northwind.sdfТ.е. мы просто указываем пути к файлу данных SSCE (.sdf) и путь к файлу с результатами. На выходе получаем .dbml-файл, который теперь можем запросто добавить в проект и работать с SSCE уже через LINQ to SQL. В конструкторе context-класса нас попросят указать connection string следующего вида: "Data Source=.\\\\Northwind.sdf"
Однако, на этом наши проблемы не закончатся. При первом запуске может возникнуть ошибка:
\nCannot open \"Northwind.sdf\". Provider 'System.Data.SqlServerCe.3.5' not installed.1Все дело в том, что в корневом конфигурационном файле не прописан провайдер для SSCE, поэтому в config-файле своего приложения сделаем это:
\n<configuration>\n <system.data>\n <DbProviderFactories>\n <remove invariant=\"System.Data.SqlServerCe.3.5\" />\n <add name=\"Microsoft SQL Server Compact Data Provider\"\n invariant=\"System.Data.SqlServerCe.3.5\"\n description=\".NET Framework Data Provider for Microsoft SQL Server Compact\"\n type=\"System.Data.SqlServerCe.SqlCeProviderFactory, System.Data.SqlServerCe, Version=3.5.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91\" />\n </DbProviderFactories>\n </system.data>\n</configuration>Собственно, эти данные прописываются в machine.config автоматически, если мы устанавливаем SSCE Windows Installer-ом (а не через x-copy).
Если у вас Windows 32-bit, то на этом шаге у вас все должно заработать. Однако мне повезло меньше - у меня Windows 64-bit, из-за чего проблемы продолжились. Насколько мне удалось найти информацию на эту тему я сделал вывод - на данный момент SSCE работает только в 32-разрядном режиме. Поэтому проблему можно решить определив, что проект компилируется для x86 (в Configuration Manager).
\nДругой, более изощренный способ - использовать утилиту "corflags.exe", которая позволяет включить 32-битный режим уже для готовой сборки:
corflags ...\\bin\\Debug\\consoleapplication1.exe /32BIT+Вывод. Использовать LINQ2SQL и SSCE можно, но не без проблем :)
\nUpdated: поддержка x64 будет в SSCE 3.5 SP1.
", "tags": [ "LINQ" ], "banner_image": "https://blog.zwezdin.com/2008/linq2sql-sqlcompact/33f7646b/linq2sql_sqlcompact@cover.jpg" }, { "id": "https://blog.zwezdin.com/2008/zoomit/", "url": "https://blog.zwezdin.com/2008/zoomit/", "title": "ZoomIt для ваших презентаций", "date_published": "2008-03-31T12:00:00.000Z", "content_html": "На последних Днях Разработчиков у некоторых докладчиков заметил интересную утилиту. Она позволяет во время доклада увеличивать участки экрана (zoom). Это может быть удобно, например, когда вы показываете участки кода во время демонстраций и т.д. Кроме того, она умеет рисовать на экране и включать таймер обратного отсчета.
\nИтак, встречайте - ZoomIt by Марк Руссинович (sysinternals). Каково было мое удивление, когда я узнал, что кроме того, что она бесплатная, она еще и весит всего 44 Кб в архиве.
\n\n\n\n![\"ZoomIt](\"https://blog.zwezdin.com/2008/zoomit/0dc27ab5/1@2x.png\")
\n\n\n\n\nСкачивайте и делайте ваши презентации ярче!
", "tags": [ "Tools" ], "banner_image": "https://blog.zwezdin.com/2008/zoomit/f5cde781/zoomit@cover.jpg" }, { "id": "https://blog.zwezdin.com/2008/extensions-methods/", "url": "https://blog.zwezdin.com/2008/extensions-methods/", "title": "Использование Extensions Methods для создания экземпляра класса", "date_published": "2008-03-12T13:00:00.000Z", "content_html": "С момента появления C#3.0 нашлось достаточно много интересных применений extensions method’ам. Различных вариаций на эту тему достаточно большое множество, и в этом посте мне бы хотелось дополнить эту копилку еще одним таким примером.
\nДело в том, что в силу специфики своего проекта мне достаточно часто приходится инстанциировать объекты основываясь на строковом имени класса (знаем строку, в которой задано имя класса => получаем экземпляр этого класса). Конечно, каждый из вас знает что делается это, например, при помощи объекта Activator. Например так:
object o = Activator.CreateInstance(Type.GetType(@\"WindowsFormsApplication1.Class1\", false));Однако, если поиграться с extensions method’ами, то можно сделать следующее.
\nОпределим extension method:
\npublic static class InstanceExtension\n{\n public static object CreateInstance(this string type)\n {\n return Activator.CreateInstance(Type.GetType(type, false));\n }\n}Теперь воспользуемся им:
\nobject o = \"WindowsFormsApplication1.Class1\".CreateInstance();Помоему выглядит достаточно интересно. Если пример немного усложнить и добавить какую-либо логику в реализацию extension method (например, инжектирование через DI в новоиспеченный инстанс какого-либо объекта, если он реализует заданный контракт, итд), то толк из этого может вполне получится.
", "tags": [ "C#", ".NET", "LINQ" ], "banner_image": "https://blog.zwezdin.com/2008/extensions-methods/4c26a765/extensions_methods@cover.jpg" }, { "id": "https://blog.zwezdin.com/2007/wcf-cache/", "url": "https://blog.zwezdin.com/2007/wcf-cache/", "title": "Кэширование в Windows Communication Foundation (WCF)", "date_published": "2007-07-18T12:00:00.000Z", "content_html": "Те, кто уже начал промышленное использование Windows Communcation Foundation в своих разработках уже наверняка столкнулись с множеством проблем различного характера.
\nОдной из таких проблем является кэширование результатов выполнения операций в рамках сервиса.
\n\n\nКак оказалось решение данной проблемы не такая уж и сложная задача. Чтобы осуществить это необходимо создать и подменить стандартный Invoker.
Для реализации своего Invoker-а необходимо создать новый класс и реализовать в нем интерфейс IOperationInvoker. При этом необходимо сохранить ссылку на “оригинальный” Invoker. В новоиспеченном Invoker-е нас интересует следующий метод:
public object Invoke(object instance, object[] inputs, out object[] outputs)Переопределив его, мы можем контролировать процесс выполнения операции на сервисе. Самое простое что можно сделать - это вызвать метод Invoke “оригинального” Invoker-а. Но кто нам мешает сделать еще несколько манипуляций перед этим? Именно тут мы и реализуем логику кэширования. Для самого простого случая это выглядить примерно так:
public object Invoke(object instance, object[] inputs,\n out object[] outputs)\n{\n string result = String.Empty;\n int invokeInputParam = (int)inputs[0];\n\n if (_cacheDictionary.ContainsKey(invokeInputParam) == true)\n {\n Console.WriteLine(@\"Cached for param value: \" + invokeInputParam.ToString());\n result = _cacheDictionary[invokeInputParam];\n }\n else\n {\n result = (string)_baseInvoker.Invoke(instance, inputs, out outputs);\n _cacheDictionary.Add(invokeInputParam, result);\n }\n\n outputs = new object[] { };\n return result;\n}После реализации Invoker-а необходимо каким-то образом “прикрутить” его к операции. Вариантов тут много. Один из них — создать класс-атрибут, в котором реализован интерфейс IOperationBehavior. Здесь, в методе ApplyDispatchBehavior как раз необходимо выполнить подмену Invoker-а:
public void ApplyDispatchBehavior(OperationDescription operationDescription,\n System.ServiceModel.Dispatcher.DispatchOperation dispatchOperation)\n{\n dispatchOperation.Invoker = new CacheInvoker(dispatchOperation.Invoker);\n}Осталось только навесить данный атрибут на операцию при реализации сервиса и все готово:
\n[Cache]\npublic string LongOperation(int a)\n{\n System.Threading.Thread.Sleep(2000);\n return String.Format(\"Result {0} / DateTime: {1}\", a, DateTime.Now);\n}Аналогичным образом можно организовать не только кэширование, но и различные другие операции. Например, формировать список выполненных операций и отправлять их на e-mail.
", "tags": [ "Windows Communication Foundation" ], "banner_image": "https://blog.zwezdin.com/2007/wcf-cache/55f78d0a/wcf_cache@cover.jpg" }, { "id": "https://blog.zwezdin.com/2007/avoid-security-dll-names/", "url": "https://blog.zwezdin.com/2007/avoid-security-dll-names/", "title": "Не называйте свои сборки \"security.dll\"", "date_published": "2007-04-20T12:00:00.000Z", "content_html": "Недавно, работая над текущим проектом, потратил кучу времени, разбираясь с загадочным исключением - “Не удается найти точку входа EnumerateSecurityPackagesW в DLL (security.dll)“.
\nПредыстория. Приложение на базе WCF. На сервисной части запускается набор сервисов. Затем на клиентской части вызываются методы удаленного объекта. Все работало замечательно. До тех пор, пока я не начал писать Security часть всего этого.
\nВ какой-то момент времени все просто перестало работать — на клиенте выбрасывалось указанное исключение. Все мои попытки что-либо сделать ни к чему не приводили. После того как я просидел с этой проблемой некоторое время выяснилось следующее.
\nПосле того, как я из главного проекта добавил Reference на сборку Security, у меня, естественно, в папке с исполняемым файлом появился файлик "security.dll". WCF работал поверх HTTP, используя защищенное соединение (т.е. https). При работе через http инфраструктура WCF, видимо, использует объект HttpWebRequest. Как позже выяснилось, при работе через защищенные соединения, HttpWebRequest импортирует библиотеку "C:\\Windows\\System32\\security.dll", которая является частью ОС. Причем, при импорте данной библиотеки он смотрит сначала в папку, в которой находится исполняемый файл моей программы, а только потом - в System32. Соответственно, когда я сделал Reference на свою сборку "Security", она скопировалась в папку с программой и HttpWebRequest пытался загрузить ее. Теперь понятно откуда исключение :)
Для меня такое решение (поиск библиотеки в папке с программой) достаточно сомнителен в данной ситуации. А что если бы я при разработке использовал NetTcpBinding или HTTP, но не защищенный? А потом у Заказчика развернул бы на базе HTTPS? Поэтому, рекомендую не использовать в качестве имени сборки название "security.dll".
Ну и напоследок, продемонстрируем как это “работает”. :) Создаем приложение и добавляем следующий код:
\nHttpWebRequest webRequest = (HttpWebRequest)WebRequest.Create(\"https://mcp.microsoft.com/mcp/\");\nWebResponse response = webRequest.GetResponse();\nStream responseStream = response.GetResponseStream();\nStreamReader r = new StreamReader(responseStream);\nMessageBox.Show(r.ReadToEnd());\nresponseStream.Close();Запускаем, видим HTML-код с сайта Microsoft. Заходим в папку с программой и создаем пустой файл с названием "security.dll".
Запускаем указанный выше код еще раз. “Наслаждаемся”. :)
\nНу и повторюсь еще раз, что если работать не через https, то HttpWebRequest не импортирует указанную библиотеку и все работает нормально.
", "tags": [ "Tips&Tricks" ], "banner_image": "https://blog.zwezdin.com/2007/avoid-security-dll-names/e01fbe41/avoid_security-dll-names@cover.jpg" }, { "id": "https://blog.zwezdin.com/2007/icq-bots/", "url": "https://blog.zwezdin.com/2007/icq-bots/", "title": "ICQ-боты", "date_published": "2007-03-06T13:00:00.000Z", "content_html": "До сегодняшнего дня думал что ICQ-боты — это зло. Как оказалось - не всегда :-)
\n\n\nИтак, сначала поясню что это такое для тех кто не в курсе. Как говорит Wikipedia, ICQ-бот - компьютерная программа, работающая по протоколу ICQ и выполняющая различные функции. Принцип работы: бот принимает входящие сообщения, анализирует их и отсылает результат выполнения и/или выполняет нужную команду.
\nСначала меня поразил бот от Gismeteo - пишешь ему в ICQ свой город, а он в ответ - прогноз погоды. Удобно! Особенно если трафик ICQ не учитывается провайдером:)))
\nНо на этом я не остановился и решил посмотреть что Google знает о ICQ-ботах. Как выяснилось, этих самых ботов существует досточно большое количество, причем далеко не все являются бесполезными:) Вот некоторые из них:
\n474974 - отсылаем название города - получаем в ответ прогноз погоды319550804, 335297520 — анекдоты8666668 — переводчик660668 — представляет собой средство получения различной информации из различных источников, например: новости, прогнозы погоды, программа телепередач, гороскопы, курсы валют и т.п.744444 — представляет собой ICQ-шлюз, т.е. мы можем говорить с кем-угодно от имени этого номера. (!help - справка по командам)4444444 - просто бот-болталка. Ради интереса, стоит хотя бы пять минут поговорить с ним. Для осознания, так сказать, проблем, стоящих перед искусственным интеллектом.236056743 - бот для внесения новых записей в Живой Журнал.Подумалось - как бы было неплохо сделать бот для добавления записей в блоги (dasblog, например), форумы gotdotnet и т.д.
\nВобщем, интересная идея :-)
", "tags": [ "Tools" ], "banner_image": "https://blog.zwezdin.com/2007/icq-bots/196ea94e/icq_bots@cover.jpg" }, { "id": "https://blog.zwezdin.com/2007/iis-apache/", "url": "https://blog.zwezdin.com/2007/iis-apache/", "title": "Как подружить Apache и IIS", "date_published": "2007-02-13T13:00:00.000Z", "content_html": "Довелось как-то решать задачу: в интрасети на одном и том же сервере необходимо установить два веб-сервера - IIS и Apache; причем чтобы оба отзывались по 80 порту, только по разным DNS-именам.
\n\n\nЕстественно было решено назначить сетевому интерфейсу 2 IP-адреса, и “раскидать“ оба сервера на разные адреса и соответствующим образом настроить DNS. Однако, не тут то было! :-) IIS напрочь отказывался стартовать в таких условиях. После некоторого изучения проблемы выяснилось следующее.
\nИтак, у нас имеется сервер на Windows 2003 Server. Для одного и того же сетевого интерфейса прописано два разных IP.
\nПроблема в том, что сервер IIS по умолчанию делает привязку ко всем IP-адресам. Но нам нужно привязаться только к 1 IP. Поможет нам в этом утилита httpcfg.exe. Найти ее можно в архиве Support.cab, который находится в папке Support\\Tools на оригинальном диске Windows 2003.
Итак, чтобы задать IP-адрес, к которому будет привязываться IIS делаем так:
\nhttpcfg set iplisten -i xxx.xxx.xxx.xxxПосле этого можно посмотреть результат запроса следующим образом:
\nhttpcfg query iplistenТеперь осталось привязать Apache ко второму IP и перезапустить IIS.
\nГотово. Проверялось на IIS6.
", "tags": [ "ASP.NET", "IIS" ], "banner_image": "https://blog.zwezdin.com/2007/iis-apache/125d92d7/iis_apache@cover.jpg" }, { "id": "https://blog.zwezdin.com/2007/windows-vista-rospatent/", "url": "https://blog.zwezdin.com/2007/windows-vista-rospatent/", "title": "Россиянин зарегистрировал Windows Vista в Роспатенте", "date_published": "2007-01-25T13:00:00.000Z", "content_html": "По утверждению Антона Серго, президента компании «Интернет и право», Федеральная служба по интеллектуальной собственности, патентам и товарным знакам (Роспатент) зарегистрировала на него программу для ЭВМ Windows Vista.
\n\n\n\n![\"Россиянин](\"https://blog.zwezdin.com/2007/windows-vista-rospatent/b647a7ed/vista@2x.jpg\")
\n\n\n\n\n«Этой регистрацией я хочу показать особенности законодательства, а не нажиться на перепродаже прав на Windows Vista кому-либо, мне не хочется злить или раздражать Microsoft», — заявил Антон Серго. На вопрос, как такая регистрация могла быть возможной, он ответил, что российское законодательство не препятствует созданию и регистрации объектов с одинаковыми названиями.
", "tags": [ "Fun" ], "banner_image": "https://blog.zwezdin.com/2007/windows-vista-rospatent/9ff8134f/windows_vista-rospatent@cover.jpg" }, { "id": "https://blog.zwezdin.com/2007/dead-messagebox/", "url": "https://blog.zwezdin.com/2007/dead-messagebox/", "title": "Убийственный MessageBox", "date_published": "2007-01-13T13:00:00.000Z", "content_html": "Случайно обнаружил на просторах интернета обсуждение, в котором объясняется как в несколько строчек убить Windows.
\nИтак, для начала код.
\nВариант на C#:
\nclass MboxTest\n{\n [DllImport(\"user32.dll\")]\n unsafe public static extern int MessageBoxA(uint hwnd, byte* lpText, byte* lpCaption, uint uType);\n\n static unsafe void Main()\n {\n byte[] helloBug = new byte[] {0x5C, 0x3F, 0x3F, 0x5C, 0x21, 0x21, 0x21, 0x00};\n uint MB_SERVICE_NOTIFICATION = 0x00200000u;\n fixed(byte* pHelloBug = &helloBug[0])\n {\n for(int i=0; i<10; i++)\n MessageBoxA(0u, pHelloBug, pHelloBug, MB_SERVICE_NOTIFICATION);\n }\n }\n}Вариант на С++:
\nchar bug [] = \"\\\\??\\\\C:\\\\\";\nfor(int i = 0; i < 10; i ++)\n{\n ::MessageBoxA(0, bug, bug, MB_SERVICE_NOTIFICATION);\n}Результатом работы данного кода является несколько MessageBox-ов и…. синий экран!
\nСамое интересное, что данный баг работает на многих версиях Windows, в т.ч. на Vista.
", "tags": [ "Fun" ], "banner_image": "https://blog.zwezdin.com/2007/dead-messagebox/a69919f0/dead_messagebox@cover.jpg" } ] }