Skip to content
C# code generator for reading and writing the protocol buffers format
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
CodeGenerator Use "global::" to avoid namespace-class collision. Jul 4, 2016
CodeWriter CodeWriter. writing <param> comments Feb 26, 2016
TestLibrary Old tests compiling and passing May 5, 2016
TestProgram Test SkipKey and PositionStream added Seek feature. May 5, 2016
UnitTestProject
commandline @ e00dd9f New command line syntax. Aug 7, 2013
packages Converted test to NUnit tests Jan 2, 2015
.gitignore .gitignore packages/ Apr 22, 2015
.gitmodules New command line syntax. Aug 7, 2013
Apache License, Version 2.0.txt Changed license to the Apache License 2.0 Apr 28, 2012
Building.markdown Import implemented Jun 5, 2015
COPYING Apache License, Version 2.0.txt Changed license to the Apache License 2.0 Apr 28, 2012
CodeGenerator.sln Old tests compiling and passing May 5, 2016
README.markdown Fixed spelling of preserveunknown Aug 25, 2016
Test.sln

README.markdown

Protocol Buffers C# Code Generator

https://silentorbit.com/protobuf/

C# code generator for serialization into Googles Protocol Buffers wire format.

Parses a .proto file and generates C# source files with classes for every message as well as code for reading and writing them to the Protocol Buffers binary format.

Download

Get the precompiled binaries here.

Get the source using git:

git clone https://github.com/hultqvist/ProtoBuf.git --recursive

Don't use the "download zip" feature on github as it won't include submodules such as CommandLine

Basic Features

  • CodeGenerator - transform a .proto specification directly into complete c# code.
  • Generated code is relatively easy to debug(only hope you wont have too)
  • Generated code does not use reflection, works after code obfuscation.

Advanced Features

These features are local to this project. They affect how you will work with the generated code. It does not affect the final wire format. Any other Protocol Buffers implementation should be able to communicate using the same .proto specification.

For the latest features, see Test/csharpgen.proto

These local features are implemented in the Test project.

Message options:

  • access - set the acces of the generated class to internal rather than public.
  • triggers - have the class methods BeforeSerialize and AfterDeserialize called accordingly.
  • preserveunknown - keep all unknown fields during deserialization to be written back when serializing the class.
  • external - generate serialization code for a class we don't have control over, such as one from a third party DLL.
  • imported - utilize already generated code in the current generated messages.
  • type - default: class, but you can make the serializer work with struct or interfaces.

Field options:

  • access - default: public, can be any, even private if generating a local class(default)
  • codetype - set an int64 field type to "DateTime" or "TimeSpan", the serializer will do the conversion for you.
  • generate - if set to false(default: true), the field/property is expected to be defined elsewhere in the project rather than the generated code.
  • readonly - make the message field a c# readonly field rather than a property.

Example

This is a part of the Test/Example.proto:

package ExampleNamespace;

message Person {
  option namespace = "Personal";
  
  required string name = 1;
  required int32 id = 2;
  optional string email = 3;

  enum PhoneType {
    MOBILE = 0;
    HOME = 1;
    WORK = 2;
  }

  message PhoneNumber {
    required string number = 1;
    optional PhoneType type = 2 [default = HOME];
  }

  repeated PhoneNumber phone = 4;
}

When compiled it you will have the following class to work with.

public partial class Person
{
	public enum PhoneType
	{
		MOBILE = 0,
		HOME = 1,
		WORK = 2,
	}

	public string Name { get; set; }
	public int Id { get; set; }
	public string Email { get; set; }
	public List<Personal.Person.PhoneNumber> Phone { get; set; }


	public partial class PhoneNumber
	{
		public string Number { get; set; }
		public Personal.Person.PhoneType Type { get; set; }
	}
}

Writing this to a stream:

Person person = new Person();
...
Person.Serialize(stream, person);

Reading from a stream:

Person person2 = Person.Deserialize(stream);

Usage

CodeGenerator.exe Example.proto [output.cs]

If the optional output.cs parameter is omitted it will default to the basename of the .proto file. In this example it would be Example.cs

The output is three files.

  • Example.cs - Basic class declaration(based on .proto).
  • Example.Serializer.cs - Code for reading/writing the message.
  • ProtocolParser.cs - Functions for reading and writing the protobuf wire format, static, not related to the contents of your .proto.

If you generate code from multiple .proto files you must only include ProtocolParser.cs once in your project.

Direct Contact, FeedBack, Bugs

You can contact me using phq@silentorbit.com .

Public issues can also be submitted to the GitHub project page.

Licence, Apache License version 2.0

All source code and generated code is licensed under the Apache License Version 2.0.

You can’t perform that action at this time.