Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Поскольку событие состоит в основном из непрозрачного набора байтов, получателям событий может быть трудно принимать обоснованные решения о способах их обработки. Чтобы издатели событий могли предлагать получателям лучший контекст, события могут также содержать настраиваемые метаданные в виде набора пар "ключ — значение". Одним из распространенных сценариев включения метаданных является предоставление подсказки о типе данных, содержащихся в событии, чтобы получатели распознали его формат и могли соответствующим образом десериализовать его.
Примечание
Эти метаданные не используются или каким-либо образом значимы для служб центров событий; они существуют только для координации между издателями событий и получателями.
В следующих разделах показано, как добавлять пользовательские данные к событиям на разных языках программирования.
.NET
var eventBody = new BinaryData("Hello, Event Hubs!");
var eventData = new EventData(eventBody);
eventData.Properties.Add("EventType", "com.microsoft.samples.hello-event");
eventData.Properties.Add("priority", 1);
eventData.Properties.Add("score", 9.0);
Полный пример кода приведен в разделе Публикация событий с пользовательскими метаданными.
Java
EventData firstEvent = new EventData("EventData Sample 1".getBytes(UTF_8));
firstEvent.getProperties().put("EventType", "com.microsoft.samples.hello-event");
firstEvent.getProperties().put("priority", 1);
firstEvent.getProperties().put("score", 9.0);
Полный пример кода приведен в разделе Публикация событий с пользовательскими метаданными.
Python
event_data = EventData('Message with properties')
event_data.properties = {'event-type': 'com.microsoft.samples.hello-event', 'priority': 1, "score": 9.0}
Полный пример кода приведен в разделе Отправка пакета данных событий со свойствами.
JavaScript
let eventData = { body: "First event", properties: { "event-type": "com.microsoft.samples.hello-event", "priority": 1, "score": 9.0 } };
Дальнейшие действия
Ознакомьтесь со следующими краткими руководствами и примерами.
- Краткие руководства: .NET, Java, Python, JavaScript
- Примеры на GitHub: .NET, Java, Python, JavaScript, TypeScript